> ## 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.
# Stap HTTP-verzoek
> Configureer gegevensuitwisseling in CFD voor slimmere, datagestuurde oproeproutering.
Met de stap **HTTP-verzoek** verbindt u uw CloudTalk-gespreksflows met externe systemen en API's. In deze handleiding leest u hoe u de stap HTTP-verzoek configureert en gebruikt om verzoeken te versturen, responsen te verwerken en externe gegevens rechtstreeks in uw gespreksflows te integreren.
**Gebruikersniveau:** Admin
***
Een stap HTTP-verzoek gebruiken
Met de stap **HTTP-verzoek** breidt u uw gespreksflows uit tot buiten CloudTalk door verbinding te maken met externe systemen en API's. Zo maakt u gegevensuitwisseling, automatisering en realtime beslissingen tijdens een gesprek mogelijk.
Of u nu gespreksgegevens verrijkt, externe records bijwerkt of klantervaringen personaliseert: met de stap HTTP-verzoek bouwt u flexibel slimmere en beter verbonden workflows.
Een HTTP-verzoek aan uw gespreksflow toevoegen
1. Klik in het **Dashboard** op **Nummers**.
2. Zoek op het tabblad **Mijn nummers** het nummer dat u wilt configureren.
3. Klik in de kolom **Gespreksstroom** op **+ Configureren** (of op de naam van de flow, als die er al is).
4. Klik op het canvas op de knop **`+`** op de plek waar u de stap wilt invoegen.
5. Selecteer in de stappenbibliotheek onder **Automatisering** de optie **HTTP-verzoek**.
HTTP-verzoeken configureren
6\. Klik op het canvas op de stap HTTP-verzoek om het configuratiepaneel te openen. De volgende elementen zijn beschikbaar:
Endpoint
Het endpoint bepaalt welke URL wordt aangeroepen. De communicatie vereist HTTPS.
Methode
De methode van het HTTP-verzoek, oftewel het type actie dat de ontvanger van het endpoint moet uitvoeren. Beschikbare opties: **GET**, **POST**, **PUT**, **PATCH**, **DELETE**.
Request headers (optioneel)
Request headers bevatten meta-informatie over het verzoek, zoals de indeling van de request body of autorisatiegegevens.
Klik op **Nieuw toevoegen** om extra headers te definiëren. Welke headers u nodig hebt, hangt af van de externe API waarmee u verbinding maakt.
Request body
De request body is de payload die met het verzoek wordt meegestuurd. Klik op **Nieuw toevoegen** om sleutel-waardeparen als gegevensattributen te definiëren. U kunt ook op **Aangepast contactveld toevoegen** klikken om contactgegevens rechtstreeks in te voegen.
De request body wordt in JSON-indeling verstuurd (bijvoorbeeld: `{"key1":"value1", "key2":"value2"}`).
Naast vaste waarden kunt u de volgende dynamische variabelen gebruiken:
**Gespreksattributen:**
| **Variabele** | **Beschrijving** |
| - | - |
| `#{{call.external_number}}` | Nummer van de beller in E.164-indeling (bijv. +10005555555) |
| `#{{call.waiting_time}}` | Tijd in seconden tussen het begin van de oproep en het opnemen door de agent |
| `#{{call.uuid}}` | Unieke gespreks-ID |
| `#{{call.agent_id}}` | Agent-ID (alleen op een beantwoorde tak, anders wordt null geretourneerd) |
| `#{{call.agent_email}}` | E-mailadres van de agent (alleen op een beantwoorde tak, anders wordt null geretourneerd) |
**Contactattributen:**
| **Variabele** | **Beschrijving** |
| - | - |
| `#{{contact.name}}` | Naam van contact |
| `#{{contact.id}}` | Contact-ID |
| `#{{contact.title}}` | Functietitel van contact |
| `#{{contact.company}}` | Bedrijf van contact |
| `#{{contact.industry}}` | Branche van contact |
| `#{{contact.address}}` | Adres van contact |
| `#{{contact.city}}` | Plaats van contact |
| `#{{contact.zip}}` | Postcode van contact |
| `#{{contact.state}}` | Provincie van contact |
| `#{{contact.type}}` | Retourneert "contact" of "lead" |
| `#{{contact.tags}}` | Retourneert een array met toegewezen tags (bijv. `["Vip", "CampaignA"]`) |
| `#{{contact.custom_fields["field_name"]}}` | Waarde van een aangepast veld (bijv. `#{{contact.custom_fields["MRR"]}}`) |
| `#{{contact.emails}}` | Retourneert een array met e-mailadressen van het contact |
| `#{{contact.emails[0]}}` | Retourneert het eerste e-mailadres uit de array |
**Invoer verzamelen:**
| **Variabele** | **Beschrijving** |
| - | - |
| `#{{input[step_id].value}}` | Waarde die de beller invoert tijdens een stap Invoer verzamelen. Vervang *step\_id* door de stap-ID van de stap Invoer verzamelen (bijv. `#{{input[389008].value}}`). |
**Tip:** Sla uw flow op voordat u naar een stap-ID verwijst. Vóór het opslaan hebben stappen tijdelijke negatieve ID's die mogelijk niet goed werken. Na het opslaan wordt de stap-ID een permanent positief nummer.
**Let op:** Invoer verzamelen kan een lege waarde retourneren als de beller niets heeft ingevoerd. Tijdens het aanmaken kunt u de tijdelijke ID gebruiken; die wordt vervangen nadat de flow is opgeslagen.
Nestingopties
Als een extern endpoint geneste objecten vereist, gebruikt u puntnotatie in het veld Key: `key.subkey`.
Bijvoorbeeld:
* `customer.firstname` = John
* `customer.lastname` = Doe
Dit levert op: `{ "customer": { "firstname": "John", "lastname": "Doe" }}`
***
Respons parsen
Het selectievakje **Respons parsen** bepaalt hoe CloudTalk omgaat met gegevens die van het externe systeem worden ontvangen.
* **Wanneer uitgeschakeld**
De gespreksflow gaat direct na het versturen van het verzoek verder, zonder op een respons te wachten. Handig voor fire-and-forget-verzoeken waarbij de responsgegevens niet nodig zijn.
- **Wanneer ingeschakeld**
De gespreksflow wacht op de HTTP-respons voordat hij verdergaat. De geretourneerde gegevens zijn daarna beschikbaar voor gebruik in volgende stappen.
Gegevens behouden na oproep
Vink **Gegevens behouden na oproep** aan om de gegevens uit de HTTP-respons beschikbaar te houden nadat de oproep is beëindigd. Dat is handig als u de gegevens nodig hebt voor verwerking of rapportage na het gesprek.
***
De respons in latere stappen gebruiken
Als Respons parsen is ingeschakeld, kunt u de responsbody gebruiken in een [Voorwaardesplitser](/nl/articles/5763009-caller-based-routing-with-conditions) om oproepen te routeren op basis van de geretourneerde gegevens.
In de configuratie van de Voorwaardesplitser:
1\. Selecteer **HTTP-respons** in het vervolgkeuzemenu **Eigenschap**. Daar ziet u de endpoint-URL van de stap HTTP-verzoek (bijv. "HTTP-respons - [https://api.example.com/customer](https://api.example.com/customer)"), zodat u weet naar welk verzoek wordt verwezen.
2\. Voer het **JSON-pad** naar de responseigenschap in met puntnotatie.
**Voorbeeld:** Als de respons er zo uitziet:
```json theme={"system"}
{
"status": "success",
"error": {
"code": 200,
"message": "OK"
}
}
```
* Om te verwijzen naar de eigenschap *status* op het hoogste niveau gebruikt u: `status`
* Om te verwijzen naar de geneste eigenschap *error code* gebruikt u: `error.code`
* Gebruik voor geïndexeerde eigenschappen (lijst of array) puntnotatie met het indexnummer: `status.0` voor het eerste item, `status.1` voor het tweede, enzovoort.
3\. Stel de gewenste voorwaarde in (**Operand** en **Waarde**) op basis van wat u wilt matchen.
Met deze opzet stuurt elke oproep die de stap HTTP-verzoek bereikt een verzoek naar het externe systeem. De responsgegevens bepalen vervolgens het verdere routeringspad van de oproep, zodat elke oproep dynamisch wordt afgehandeld op basis van de meest actuele informatie.
***
*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) — we staan voor u klaar.
## Related topics
- [De stap Invoer van beller verzamelen](/nl/articles/5878950-collect-input-from-caller-step.md)
- [Uw Salesforce-integratie gebruiken in HTTP-verzoeken in de gespreksflow](/nl/articles/16941452-using-your-salesforce-integration-in-call-flow-http-requests.md)
- [Enquête na afloop van het gesprek](/nl/articles/8200861-post-call-survey.md)
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.