Zum Hauptinhalt springen

Integrationen verbinden

Pragma unterscheidet drei Setup-Arten. Auf der Seite Kanaele verbinden siehst du die passende Variante direkt auf jeder Karte.

OAuth: direkt verbinden​

OAuth ist der beste Weg, wenn Pragma eine Provider-App besitzt und du dich beim Anbieter anmelden kannst.

  • Microsoft Teams: Mit Microsoft verbinden, Zustimmung geben, danach Team und Kanal waehlen.
  • Slack: Mit Slack verbinden, Ziel-Channel im Slack-Dialog auswaehlen. Pragma speichert die Incoming-Webhook-URL automatisch.
  • HubSpot: Mit HubSpot verbinden. Falls OAuth noch nicht im Deployment aktiviert ist, nutze voruebergehend eine HubSpot Private App.
  • Pipedrive: Mit Pipedrive verbinden. Pragma speichert Access Token, Refresh Token und Firmen-Domain automatisch.
  • Salesforce: Mit Salesforce verbinden. Pragma speichert Access Token, Refresh Token und Instance URL automatisch.

Damit die One-Click-Buttons sichtbar sind, muessen die Provider-Apps im Deployment konfiguriert sein:

  • Pipedrive App: PIPEDRIVE_CLIENT_ID, PIPEDRIVE_CLIENT_SECRET; Redirect-URL https://app.mikemuellers.de/api/oauth/pipedrive/callback
  • Salesforce Connected App: SALESFORCE_CLIENT_ID, SALESFORCE_CLIENT_SECRET; Redirect-URL https://app.mikemuellers.de/api/oauth/salesforce/callback; OAuth Scopes api und refresh_token
  • Salesforce Sandbox oder eigener Login-Host: optional SALESFORCE_LOGIN_URL, z. B. https://test.salesforce.com

API-Key: Wert kopieren​

Bei API-Key-Integrationen erzeugst du den Token beim Anbieter und speicherst ihn unter Eigene Zugangsdaten.

  • HubSpot Private App: HUBSPOT_ACCESS_TOKEN
  • Pipedrive: PIPEDRIVE_API_TOKEN plus PIPEDRIVE_COMPANY_DOMAIN
  • Salesforce: SALESFORCE_ACCESS_TOKEN plus SALESFORCE_INSTANCE_URL
  • Trello: TRELLO_API_KEY, TRELLO_TOKEN, TRELLO_LIST_ID
  • AI: OpenAI oder Azure OpenAI Zugangsdaten

Callback: URL beim Anbieter eintragen​

WeCom, WeChat Official Account und WhatsApp empfangen eingehende Nachrichten ueber eine Callback-URL. Kopiere die URL aus der Pragma-Karte und trage sie exakt beim Anbieter ein.

  • WeCom: /webhooks/wecom
  • WeChat Official Account: /webhooks/wechat-oa
  • WhatsApp Cloud API: /webhooks/whatsapp

Wenn eine Verbindung scheitert, oeffne den Hilfe-Drawer auf der Verbinden-Seite. Dort findest du Produktvideo, Best-Practice-Artikel und den KI-Hilfe-Assistenten.