Skip to main content
De stap HTTP-verzoek kan uw Salesforce-org rechtstreeks aanroepen. Wanneer het eindpunt het adres van uw Salesforce-org is, ondertekent CloudTalk het verzoek met uw gekoppelde Salesforce-integratie, zodat u nooit Salesforce-inloggegevens in de gespreksflow invoert.
Gebruikersniveau: Admin

​
Voordat u begint

  • Uw Salesforce-integratie moet in CloudTalk gekoppeld en actief zijn (Dashboard > Integraties). Zie Salesforce configureren.
  • Het eindpunt moet het eigen domein van uw org gebruiken, bijvoorbeeld https://yourcompany.my.salesforce.com/.... Andere Salesforce-adressen zoals login.salesforce.com of Marketing Cloud worden niet ondersteund.
  • U moet weten welke Salesforce REST API-aanroep u wilt doen. In de API-documentatie van Salesforce vindt u de beschikbare eindpunten.

​
Het verzoek instellen

  1. Voeg een stap HTTP-verzoek toe aan uw gespreksflow (zie de handleiding HTTP-verzoekstap).
  2. Voer bij Eindpunt de volledige Salesforce API-URL op uw org-domein in.
  3. Kies de Methode en vul Verzoekheaders en Verzoekinhoud in zoals de Salesforce API dat vereist. Voeg voor een JSON-inhoud de header Content-Type: application/json toe.
  4. Voeg geen Authorization-header toe. CloudTalk regelt de authenticatie voor u via de gekoppelde integratie.
  5. Sla de gespreksflow op.
Telkens wanneer een oproep bij deze stap aankomt, stuurt CloudTalk het verzoek namens uw integratie naar Salesforce. U kunt dynamische variabelen zoals #{{call.external_number}} gebruiken in het eindpunt, de headers en de inhoud, precies zoals in elke andere stap HTTP-verzoek.

​
Voorbeeld: een inkomende oproep vastleggen als Salesforce-Task

VeldWaarde
Eindpunthttps://yourcompany.my.salesforce.com/services/data/v58.0/sobjects/Task
MethodePOST
HeadersContent-Type = application/json
InhoudOnderwerp = Inbound call from #{{call.external_number}}Status = VoltooidPrioriteit = Normaal
Respons parsenUit (fire and forget)

​
De Salesforce-respons gebruiken in een Voorwaardesplitser

Als Respons parsen is ingeschakeld, wordt het antwoord van Salesforce als één blok opgeslagen. In een Voorwaardesplitser kunt u:
  • De statuscode controleren: selecteer HTTP-respons, pad statusCode, bijvoorbeeld gelijk aan 200.
  • Controleren of het antwoord een waarde bevat: selecteer HTTP-respons, pad body, operand bevat.
Let op: Het uitlezen van een specifiek Salesforce-veld uit de respons (bijvoorbeeld records.0.Id) wordt op dit moment niet ondersteund.

​
Als de integratie niet beschikbaar is

Als uw Salesforce-integratie is uitgeschakeld of niet is gekoppeld, of als het eindpunt niet overeenkomt met de org waaraan de integratie gekoppeld is, wordt het verzoek niet naar Salesforce verstuurd. De stap wordt als mislukt geregistreerd en de gespreksflow gaat verder naar de volgende stap. Dit heeft geen gevolgen voor bellers.

​
Goed om te weten

  • De communicatie vereist HTTPS.
  • Als Respons parsen aanstaat, wacht de flow maximaal 10 seconden op een antwoord van Salesforce. Staat het uit, dan wordt het verzoek verstuurd en gaat de flow na maximaal 3 seconden verder.
  • Verzoeken tellen net als elke andere API-aanroep mee voor uw Salesforce API-limieten.
Hulp nodig of hebt u een vraag? Neem gerust contact met ons op via ons Supportportaal. Wij staan voor u klaar.