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

# Een VoiceAgent-oproep activeren vanuit Kustomer

> Start CloudTalk VoiceAgent-oproepen rechtstreeks vanuit Kustomer Workflows

<Note>
  U kunt automatisch een CloudTalk VoiceAgent-oproep starten met Kustomer Workflows. In deze handleiding leest u hoe u de trigger instelt, klantgegevens doorgeeft aan CloudTalk en controleert of de oproep is gestart
</Note>

**Gebruikersniveau:** Admin

***

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

U hebt nodig:

* Een al aangemaakte CloudTalk VoiceAgent (noteer de VoiceAgent-ID)

* [CloudTalk API-inloggegevens](/nl/articles/15272380-how-to-access-and-generate-your-cloudtalk-api-keys) (API-sleutel en Secret)

* Een Kustomer-account met toegang tot Workflows

* Klantrecords met ten minste een telefoonnummer in E.164-formaat (bijvoorbeeld `+14155550100`)

<h2 id="h_4ec6cf88b7">
  De integratie instellen
</h2>

<h3 id="h_f102838eae">
  De Authorization-header genereren
</h3>

CloudTalk gebruikt Basic Authentication voor API-verzoeken. Zo genereert u uw gecodeerde waarde:

1. Ga naar [https://www.debugbear.com/basic-auth-header-generator](https://www.debugbear.com/basic-auth-header-generator)

2. Voer uw **CloudTalk API-sleutel** en **CloudTalk API Secret** in (te vinden in uw CloudTalk-bedrijfsinstellingen).

3. Kopieer de gegenereerde header. Deze ziet er ongeveer zo uit: `Basic XXXXXXXXX`

Deze waarde plakt u in de workflowactie hieronder.

<h3 id="h_4ec45bbce8">
  Een Kustomer-workflowtrigger aanmaken
</h3>

1. Open in Kustomer **Settings > Workflows**.

2. Klik op **+ New Workflow**.

3. Kies een triggertype, bijvoorbeeld:

   * Conversation created

   * Tag added to customer

   * Customer attribute updated

4. Voeg **Conditions** toe om te bepalen wanneer de oproep wordt gestart, bijvoorbeeld alleen wanneer het telefoonnummer van de klant is ingevuld.

<Frame>
  <img src="https://mintcdn.com/cloudtalk/8FCfL6QWpEnHvO8c/images/help-center/articles/16063131/7fcc55ade706-image.png?fit=max&auto=format&n=8FCfL6QWpEnHvO8c&q=85&s=e9f64cf2515f205bb9254c04e1794010" alt="" width="956" height="775" data-path="images/help-center/articles/16063131/7fcc55ade706-image.png" />
</Frame>

<h3 id="h_cd84168c0a">
  De HTTP-verzoekactie toevoegen
</h3>

Nadat u uw trigger hebt ingesteld:

1. Klik op **+ Add Action > REST API: JSON**

2. Configureer:

   * **Method:** POST

   * **URL:** `https://api.cloudtalk.io/v1/voice-agent/calls`

   * **Headers:**

   ```json theme={"system"}
   {
     "Authorization": "Basic YOUR_AUTHORIZATION_HEADER",
     "Content-Type": "application/json"
   }
   ```

   * **Body:**

   ```json theme={"system"}
   {
     "call_number": "#{{steps.1.phones.0.phone}}",
     "voice_agent_id": "YOUR_VOICE_AGENT_ID"
   }
   ```

3. Sla de workflow op en zet deze op **Enable**

<Frame>
  <img src="https://mintcdn.com/cloudtalk/8FCfL6QWpEnHvO8c/images/help-center/articles/16063131/1e9f0aedc5e8-image.png?fit=max&auto=format&n=8FCfL6QWpEnHvO8c&q=85&s=9fe5998b434d2399ae051fff20849ef6" alt="" width="956" height="966" data-path="images/help-center/articles/16063131/1e9f0aedc5e8-image.png" />
</Frame>

**Deze actie:**

* Stuurt een POST-verzoek naar de CloudTalk VoiceAgent API

* Geeft het telefoonnummer van de klant door

* Zorgt ervoor dat uw VoiceAgent de oproep uitvoert

<Warning>
  `call_number` en `voice_agent_id` zijn de enige verplichte velden. Optioneel kunt u `call_properties` toevoegen, zoals systeempromptvariabelen (gegevens die de VoiceAgent tijdens de oproep gebruikt) en outputvariabelen (gegevens die na de oproep naar uw endpoint worden teruggestuurd), afhankelijk van uw VoiceAgent-configuratie. [Lees wat u kunt opnemen](/nl/articles/11401649-voiceagents-for-outbound-calls).
</Warning>

<Tip>
  De waarde `#{{steps.1.phones.0.phone}}` in de body verwijst naar gegevens uit een eerdere stap in uw workflow, in dit geval het telefoonnummer van de klant. U kunt dezelfde verwijzingssyntaxis gebruiken om andere klantgegevens in het verzoek op te nemen. Stel deze verwijzingen op in de workfloweditor van Kustomer, zodat ze overeenkomen met de stappen in uw workflow.
</Tip>

<h3 id="h_dc49dea7e3">
  Testen en controleren
</h3>

1. Activeer de gebeurtenis op een testklantrecord met een telefoonnummer.

2. Open **Settings > Workflows > \[Workflow Name] > Run history**.

3. Controleer in CloudTalk of de VoiceAgent-oproep is gestart.

**Klaar!** 🚀 Uw Kustomer-workflow start nu automatisch een CloudTalk VoiceAgent-oproep zodra een klant aan uw gekozen voorwaarden voldoet.

<h2 id="h_952715bf79">
  Problemen oplossen
</h2>

* **401 Unauthorized**: controleer de waarde van de Authorization-header opnieuw.

* **400 Bad Request**: controleer of het telefoonnummer in E.164-formaat staat (bijvoorbeeld +14155550100).

* **Workflow wordt niet gestart**: controleer de triggerinstellingen en of uw voorwaarden voor het testrecord kloppen.

***

Hulp nodig of hebt u een vraag? Neem 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

- [Een VoiceAgent-oproep activeren vanuit Freshdesk](/nl/articles/15457387-triggering-a-voiceagent-call-from-freshdesk.md)
- [Een VoiceAgent-oproep activeren vanuit Freshservice](/nl/articles/15502021-triggering-a-voiceagent-call-from-freshservice.md)
- [Een VoiceAgent-oproep activeren vanuit Make](/nl/articles/11830974-triggering-a-voiceagent-call-from-make.md)


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