Stap HTTP-verzoek

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

Klik in het Dashboard op Nummers.
Zoek op het tabblad Mijn nummers het nummer dat u wilt configureren.
Klik in de kolom Gespreksstroom op + Configureren (of op de naam van de flow, als die er al is).
Klik op het canvas op de knop + op de plek waar u de stap wilt invoegen.
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 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”), 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:

{
  "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 — we staan voor u klaar.

Aan de slag

Nummers & portering

AI

AI Sales Dialer

CloudTalk Phone & Go

Berichten

Dashboard

Integraties

Facturering & abonnement

Technisch nieuws & updates

Oude Dashboard

Een stap HTTP-verzoek gebruiken

Een HTTP-verzoek aan uw gespreksflow toevoegen

HTTP-verzoeken configureren

Endpoint

Methode

Request headers (optioneel)

Request body

Nestingopties

Respons parsen

Gegevens behouden na oproep

De respons in latere stappen gebruiken

​Een stap HTTP-verzoek gebruiken

​Een HTTP-verzoek aan uw gespreksflow toevoegen

​HTTP-verzoeken configureren

​Endpoint

​Methode

​Request headers (optioneel)

​Request body

​Nestingopties

​Respons parsen

​Gegevens behouden na oproep

​De respons in latere stappen gebruiken

Een stap HTTP-verzoek gebruiken

Een HTTP-verzoek aan uw gespreksflow toevoegen

HTTP-verzoeken configureren

Endpoint

Methode

Request headers (optioneel)

Request body

Nestingopties

Respons parsen

Gegevens behouden na oproep

De respons in latere stappen gebruiken