Skip to main content
Der Schritt HTTP-Anfrage kann Ihre Salesforce-Organisation direkt aufrufen. Wenn der Endpunkt die Adresse Ihrer Salesforce-Organisation ist, signiert CloudTalk die Anfrage mit Ihrer verbundenen Salesforce-Integration, sodass Sie nie Salesforce-Zugangsdaten im Anrufablauf eingeben müssen.
Benutzerebene: Admin

​
Bevor Sie beginnen

  • Ihre Salesforce-Integration muss in CloudTalk verbunden und aktiv sein (Dashboard > Integrationen). Siehe Salesforce konfigurieren.
  • Der Endpunkt muss die eigene Domain Ihrer Organisation verwenden, zum Beispiel https://yourcompany.my.salesforce.com/.... Andere Salesforce-Adressen wie login.salesforce.com oder Marketing Cloud werden nicht unterstützt.
  • Sie müssen wissen, welchen Salesforce-REST-API-Aufruf Sie durchführen möchten. Die API-Dokumentation von Salesforce listet die verfügbaren Endpunkte auf.

​
Die Anfrage einrichten

  1. Fügen Sie Ihrem Anrufablauf einen Schritt HTTP-Anfrage hinzu (siehe den Leitfaden HTTP-Anfrage-Schritt).
  2. Geben Sie unter Endpunkt die vollständige Salesforce-API-URL auf der Domain Ihrer Organisation ein.
  3. Wählen Sie die Methode und füllen Sie Anforderungs-Header und Anfrageinhalt so aus, wie es die Salesforce-API verlangt. Für einen JSON-Inhalt fügen Sie den Header Content-Type: application/json hinzu.
  4. Fügen Sie keinen Authorization-Header hinzu. CloudTalk übernimmt die Authentifizierung für Sie über die verbundene Integration.
  5. Speichern Sie den Ablauf.
Jedes Mal, wenn ein Anruf diesen Schritt erreicht, sendet CloudTalk die Anfrage im Namen Ihrer Integration an Salesforce. Sie können dynamische Variablen wie #{{call.external_number}} im Endpunkt, in den Headern und im Inhalt verwenden, genau wie in jedem anderen HTTP-Anfrage-Schritt.

​
Beispiel: Einen eingehenden Anruf als Salesforce-Task protokollieren

FeldWert
Endpunkthttps://yourcompany.my.salesforce.com/services/data/v58.0/sobjects/Task
MethodePOST
HeadersContent-Type = application/json
InhaltBetreff = Inbound call from #{{call.external_number}}Status = AbgeschlossenPriorität = Normal
Antwort parsenAus (fire and forget)

​
Die Salesforce-Antwort in einem Bedingungssplitter verwenden

Wenn Antwort parsen aktiviert ist, wird die Antwort von Salesforce als ein einziger Block gespeichert. In einem Bedingungssplitter können Sie:
  • Den Statuscode prüfen: Wählen Sie HTTP-Antwort, Pfad statusCode, zum Beispiel gleich 200.
  • Prüfen, ob die Antwort einen Wert enthält: Wählen Sie HTTP-Antwort, Pfad body, Operand enthält.
Hinweis: Das Auslesen eines bestimmten Salesforce-Felds aus der Antwort (zum Beispiel records.0.Id) wird derzeit nicht unterstützt.

​
Wenn die Integration nicht verfügbar ist

Wenn Ihre Salesforce-Integration deaktiviert oder nicht verbunden ist oder der Endpunkt nicht zu der Organisation passt, mit der sie verbunden ist, wird die Anfrage nicht an Salesforce gesendet. Der Schritt wird als fehlgeschlagen protokolliert und der Anrufablauf wird mit dem nächsten Schritt fortgesetzt. Für Anrufer hat das keine Auswirkungen.

​
Gut zu wissen

  • Für die Kommunikation ist HTTPS erforderlich.
  • Wenn „Antwort parsen” aktiviert ist, wartet der Ablauf bis zu 10 Sekunden auf die Antwort von Salesforce. Ist die Option deaktiviert, wird die Anfrage gesendet und der Ablauf nach höchstens 3 Sekunden fortgesetzt.
  • Anfragen werden wie jeder andere API-Aufruf auf Ihre Salesforce-API-Limits angerechnet.
Brauchen Sie Hilfe oder haben Sie eine Frage? Wenden Sie sich einfach über unser Support-Portal an uns. Wir sind für Sie da.