warmbly/internal/app/integration/catalog.go

// Package integration owns the third-party integrations surface: catalog
// metadata, OAuth connect flows, per-provider connect/disconnect, event-driven
// actions, and inbound webhook handling for Calendly + Cal.com.
//
// Per-provider files (oauth.go, slack.go, hubspot.go, discord.go,
// google_sheets.go, calendly.go) each handle the provider-specific request /
// response shapes. The shared service.go ties them to the connections repo so
// the dashboard reads them uniformly.
package integration

import "github.com/warmbly/warmbly/internal/models"

// Reply / bounce / meeting are the most actionable events for outbound teams,
// so they're offered as triggers on the relevant providers.
var (
	crmEvents = []string{
		string(models.WebhookEventCampaignReplyReceived),
		string(models.WebhookEventCampaignEmailBounced),
		string(models.WebhookEventCampaignUnsubscribed),
		string(models.WebhookEventMeetingBooked),
		string(models.WebhookEventMeetingCanceled),
	}
	notifyEvents = []string{
		string(models.WebhookEventCampaignReplyReceived),
		string(models.WebhookEventMeetingBooked),
		string(models.WebhookEventMeetingRescheduled),
		string(models.WebhookEventMeetingCanceled),
		string(models.WebhookEventCampaignEmailBounced),
		string(models.WebhookEventWarmupHealthChanged),
		string(models.WebhookEventDeliverabilityComplaint),
	}
)

// Catalog returns the static metadata for every integration the dashboard
// renders. Order is the catalog order users see. Per-connection Configured /
// Scopes are filled in by the service from the OAuth manager.
func Catalog() []models.IntegrationCatalogEntry {
	return []models.IntegrationCatalogEntry{
		// CRM ---------------------------------------------------------------
		{
			Provider:   models.IntegrationHubSpot,
			Name:       "HubSpot",
			Tagline:    "Push positive replies and new leads straight into your CRM.",
			Category:   models.IntegrationCategoryCRM,
			AuthMethod: string(models.IntegrationAuthOAuth),
			DocsURL:    "https://developers.hubspot.com/docs/api/overview",
			Highlights: []string{
				"One-click OAuth — no API keys to copy",
				"Create or update a HubSpot contact when a prospect replies",
				"Log the reply as a note on the contact timeline",
			},
			Events:       crmEvents,
			ActionTypes:  []string{string(models.IntegrationActionHubSpotUpsert)},
			SupportsPush: true,
		},
		{
			Provider:     models.IntegrationSalesforce,
			Name:         "Salesforce",
			Tagline:      "Sync leads, contacts, and email activity to Salesforce.",
			Category:     models.IntegrationCategoryCRM,
			AuthMethod:   string(models.IntegrationAuthOAuth),
			DocsURL:      "https://developer.salesforce.com/docs",
			Highlights:   []string{"OAuth connect", "Upsert a Salesforce contact on reply or on demand"},
			Events:       crmEvents,
			ActionTypes:  []string{string(models.IntegrationActionSalesforceUpsert)},
			SupportsPush: true,
		},
		{
			Provider:     models.IntegrationPipedrive,
			Name:         "Pipedrive",
			Tagline:      "Persons, deals, and an activity timeline that stays in sync.",
			Category:     models.IntegrationCategoryCRM,
			AuthMethod:   string(models.IntegrationAuthOAuth),
			DocsURL:      "https://developers.pipedrive.com",
			Highlights:   []string{"OAuth connect", "Upsert a person when a prospect replies"},
			Events:       crmEvents,
			ActionTypes:  []string{string(models.IntegrationActionPipedriveUpsert)},
			SupportsPush: true,
		},
		{
			Provider:     models.IntegrationClose,
			Name:         "Close",
			Tagline:      "Leads, contacts, and inbox activity for Close.",
			Category:     models.IntegrationCategoryCRM,
			AuthMethod:   string(models.IntegrationAuthAPIKey),
			DocsURL:      "https://developer.close.com",
			Highlights:   []string{"Paste your Close API key (no OAuth app available)", "Upsert a lead on reply or on demand"},
			Events:       crmEvents,
			ActionTypes:  []string{string(models.IntegrationActionCloseUpsert)},
			SupportsPush: true,
		},

		// Automation --------------------------------------------------------
		{
			Provider:    models.IntegrationZapier,
			Name:        "Zapier",
			Tagline:     "Triggers and actions across 8,000+ apps.",
			Category:    models.IntegrationCategoryAutomation,
			AuthMethod:  string(models.IntegrationAuthAPIKey),
			DocsURL:     "https://zapier.com/apps",
			Highlights:  []string{"Authenticate Zapier with a scoped Warmbly API key", "Fan events to a Zap webhook URL"},
			Events:      notifyEvents,
			ActionTypes: []string{string(models.IntegrationActionGenericWebhookPing)},
		},
		{
			Provider:    models.IntegrationMake,
			Name:        "Make",
			Tagline:     "Visual automation scenarios.",
			Category:    models.IntegrationCategoryAutomation,
			AuthMethod:  string(models.IntegrationAuthAPIKey),
			DocsURL:     "https://www.make.com/en/integrations",
			Highlights:  []string{"Authenticate Make with a scoped Warmbly API key", "Fan events to a Make webhook URL"},
			Events:      notifyEvents,
			ActionTypes: []string{string(models.IntegrationActionGenericWebhookPing)},
		},
		{
			Provider:    models.IntegrationN8N,
			Name:        "n8n",
			Tagline:     "Self-hosted automation workflows.",
			Category:    models.IntegrationCategoryAutomation,
			AuthMethod:  string(models.IntegrationAuthAPIKey),
			DocsURL:     "https://docs.n8n.io",
			Highlights:  []string{"Authenticate n8n with a scoped Warmbly API key", "Fan events to an n8n webhook URL"},
			Events:      notifyEvents,
			ActionTypes: []string{string(models.IntegrationActionGenericWebhookPing)},
		},

		// Notifications -----------------------------------------------------
		{
			Provider:   models.IntegrationSlack,
			Name:       "Slack",
			Tagline:    "Real-time alerts for positive replies, bounces, and deliverability.",
			Category:   models.IntegrationCategoryNotifications,
			AuthMethod: string(models.IntegrationAuthOAuth),
			DocsURL:    "https://api.slack.com",
			Highlights: []string{
				"One-click OAuth into your workspace",
				"Ping a channel the moment a prospect replies",
				"Warn the team when warmup health or deliverability dips",
			},
			Events:      notifyEvents,
			ActionTypes: []string{string(models.IntegrationActionSlackNotify)},
		},
		{
			Provider:    models.IntegrationDiscord,
			Name:        "Discord",
			Tagline:     "Webhook-based notifications to a server channel.",
			Category:    models.IntegrationCategoryNotifications,
			AuthMethod:  string(models.IntegrationAuthWebhook),
			DocsURL:     "https://discord.com/developers/docs/resources/webhook",
			WebhookHint: "Paste a Discord channel webhook URL.",
			Highlights:  []string{"Paste a channel webhook URL", "Ping on reply / bounce / warmup health"},
			Events:      notifyEvents,
			ActionTypes: []string{string(models.IntegrationActionDiscordNotify)},
		},

		// Meetings ----------------------------------------------------------
		{
			Provider:    models.IntegrationCalendly,
			Name:        "Calendly",
			Tagline:     "Booked, rescheduled, and canceled calls land on the contact, live.",
			Category:    models.IntegrationCategoryMeetings,
			AuthMethod:  string(models.IntegrationAuthWebhook),
			DocsURL:     "https://developer.calendly.com/api-docs/",
			WebhookHint: "Paste the URL we mint into Calendly's webhook subscription (invitee.created + invitee.canceled).",
			Highlights: []string{
				"We mint an inbound URL for you",
				"Meetings appear on the contact timeline and the Meetings page in real time",
				"Trigger automations when a call is booked (Slack ping, CRM upsert)",
				"Add a 'Book a call' button anywhere a contact is in view",
			},
		},
		{
			Provider:    models.IntegrationCalCom,
			Name:        "Cal.com",
			Tagline:     "Open-source booking, same live meeting tracking.",
			Category:    models.IntegrationCategoryMeetings,
			AuthMethod:  string(models.IntegrationAuthWebhook),
			DocsURL:     "https://cal.com/docs/core-features/webhooks",
			WebhookHint: "Paste the URL we mint into Cal.com's webhook (BOOKING_CREATED / RESCHEDULED / CANCELLED).",
			Highlights: []string{
				"We mint an inbound URL for you",
				"Meetings appear on the contact timeline and the Meetings page in real time",
				"Trigger automations when a call is booked (Slack ping, CRM upsert)",
				"Add a 'Book a call' button anywhere a contact is in view",
			},
		},

		// NOTE: Google Sheets is intentionally NOT a catalog integration. The
		// google_sheets OAuth connection still exists (it powers the on-demand
		// Lead Sync feature under Contacts), but it is no longer surfaced as an
		// integration tile and has no event-driven append-row automation. See
		// internal/app/leadsync.
	}
}