> ## Documentation Index
> Fetch the complete documentation index at: https://help.cloudtalk.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Uw Salesforce-integratie gebruiken in HTTP-verzoeken in de gespreksflow

> Roep Salesforce aan vanuit uw gespreksflow zonder inloggegevens in te voeren, via uw gekoppelde Salesforce-integratie.

<Note>
  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.
</Note>

**Gebruikersniveau:** Admin

***

<h2 id="h_sf_before_you_start">
  Voordat u begint
</h2>

* Uw Salesforce-integratie moet in CloudTalk gekoppeld en actief zijn (**Dashboard** > **Integraties**). Zie [Salesforce configureren](/nl/articles/3368501-configure-salesforce).

* 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.

<h2 id="h_sf_set_up">
  Het verzoek instellen
</h2>

1. Voeg een stap **HTTP-verzoek** toe aan uw gespreksflow (zie de handleiding [HTTP-verzoekstap](/nl/articles/6883940-http-request-step)).

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.

<h2 id="h_sf_example">
  Voorbeeld: een inkomende oproep vastleggen als Salesforce-Task
</h2>

<table>
  <tbody>
    <tr>
      <td>
        **Veld**
      </td>

      <td>
        **Waarde**
      </td>
    </tr>

    <tr>
      <td>
        **Eindpunt**
      </td>

      <td>
        `https://yourcompany.my.salesforce.com/services/data/v58.0/sobjects/Task`
      </td>
    </tr>

    <tr>
      <td>
        **Methode**
      </td>

      <td>
        POST
      </td>
    </tr>

    <tr>
      <td>
        **Headers**
      </td>

      <td>
        `Content-Type` = `application/json`
      </td>
    </tr>

    <tr>
      <td>
        **Inhoud**
      </td>

      <td>
        `Onderwerp` = `Inbound call from #{{call.external_number}}`

        `Status` = `Voltooid`

        `Prioriteit` = `Normaal`
      </td>
    </tr>

    <tr>
      <td>
        **Respons parsen**
      </td>

      <td>
        Uit (fire and forget)
      </td>
    </tr>
  </tbody>
</table>

<h2 id="h_sf_condition_splitter">
  De Salesforce-respons gebruiken in een Voorwaardesplitser
</h2>

Als **Respons parsen** is ingeschakeld, wordt het antwoord van Salesforce als één blok opgeslagen. In een [Voorwaardesplitser](/nl/articles/5763009-caller-based-routing-with-conditions) 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**.

<Tip>
  **Let op:** Het uitlezen van een specifiek Salesforce-veld uit de respons (bijvoorbeeld `records.0.Id`) wordt op dit moment niet ondersteund.
</Tip>

<h2 id="h_sf_not_available">
  Als de integratie niet beschikbaar is
</h2>

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.

<h2 id="h_sf_good_to_know">
  Goed om te weten
</h2>

* 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](https://support.cloudtalk.io/hc/en-us/requests/new?ticket_form_id=26305535257884). Wij staan voor u klaar.


## Related topics

- [Salesforce-acties](/nl/articles/9394264-salesforce-actions.md)
- [Salesforce Cadences](/nl/articles/8494589-salesforce-cadences.md)
- [Salesforce configureren](/nl/articles/3368501-configure-salesforce.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.