> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# WhatsApp

## Overzicht

Je kunt je WhatsApp-bedrijfsaccount koppelen aan een ElevenLabs-agent. De agent kan vervolgens het volgende afhandelen:

* Berichtgesprekken — tekst, spraakberichten, media en [interactieve berichten](/docs/nl/eleven-agents/whatsapp/interactive-messages)
* Gesprekken — inkomend en [uitgaand](/docs/nl/eleven-agents/whatsapp/outbound#scheduling-an-outbound-call)

Agents op andere kanalen kunnen ook WhatsApp-berichten versturen via [WhatsApp-tools](/docs/nl/eleven-agents/whatsapp/tools).

Nieuw met WhatsApp op ElevenLabs? Volg de [handleiding om aan de slag te gaan](/docs/nl/eleven-agents/whatsapp/getting-started).

## Een WhatsApp-bedrijfsaccount importeren

#### Je account importeren

Ga naar de [WhatsApp-pagina](https://elevenlabs.io/app/agents/whatsapp) en klik op de knop ***Account importeren***:

![WhatsApp-pagina](/docs/_fern-img/734d6e0c2af1c50b769700e084368bed2a8c7eccf47aece6cfb6fc5ca7623f44.webp)

#### ElevenLabs autoriseren

Hiermee open je de autorisatiestroom, waarin je je account selecteert en ElevenLabs toestemming geeft om het te beheren:

![WhatsApp-autorisatiestroom](/docs/_fern-img/9e5238e98f926582db314e9debc187a7dc29fd38a980cb732b4563b373110351.webp)

#### Een agent toewijzen

Nadat je je account hebt geïmporteerd, ga je naar de instellingenpagina waar je er een agent aan kunt toewijzen:

![WhatsApp-accountpagina](/docs/_fern-img/f5598ac70ade00048effb5ee3bf6cbc93cd61876652eb3ce5917ac21c6209bf6.webp)

> **Info**
>
> Als je geen agent aan je account toewijst, worden inkomende berichten genegeerd en worden inkomende gesprekken
> geweigerd. Je kunt echter nog steeds uitgaande gesprekken voeren.

#### WhatsApp Manager configureren

Ga naar [WhatsApp Manager](https://business.facebook.com/latest/whatsapp_manager/) om:

* Je profielfoto enzovoort te configureren: open de pagina ***Telefoonnummers***, selecteer een telefoonnummer en ga naar het tabblad ***Profiel***
* Spraakoproepen toe te staan: open de pagina ***Telefoonnummers***, selecteer een telefoonnummer en ga naar het tabblad ***Gespreksinstellingen***
* Een betaalmethode toe te voegen als je uitgaande gesprekken wilt voeren: open de pagina ***Overzicht*** en klik op de knop ***Betaalmethode toevoegen***

## Accountinstellingen

Elk geïmporteerd nummer heeft instellingen die het gedrag van de agent bepalen:

* **Berichten inschakelen** — of de agent op berichten reageert. Schakel dit uit als je ElevenLabs alleen gesprekken wilt laten afhandelen terwijl je eigen applicatie berichten verwerkt.
* **Reactie op audioberichten inschakelen** — wanneer dit is ingeschakeld (standaard), beantwoordt de agent spraakberichten met spraakberichten; wanneer dit is uitgeschakeld, antwoordt deze altijd met tekst.
* **Typindicator inschakelen** — wanneer dit is ingeschakeld (standaard), markeert de agent inkomende berichten als gelezen en toont deze een typindicator terwijl de reactie wordt opgesteld.

## Berichtgesprekken

WhatsApp-berichtgesprekken eindigen wanneer de agent de systeemtool [***Gesprek beëindigen***](/docs/nl/eleven-agents/customization/tools/system-tools/end-call) gebruikt, de geconfigureerde ***Maximale gespreksduur*** verstrijkt, of de standaard inactiviteitstime-out verstrijkt na de meest recente reactie van de agent.

> **Info**
>
> WhatsApp-berichtgesprekken hebben standaard een inactiviteitstime-out van 15 minuten, gemeten vanaf de
> meest recente reactie van de agent. Lees meer over [gesprekstime-outs](/docs/nl/eleven-agents/customization/conversation-flow#maximum-conversation-duration).

### Inkomend

Je kunt een bericht naar je WhatsApp-bedrijfsaccount sturen en de agent reageert:

![WhatsApp-tekstgesprek](/docs/_fern-img/4c31b4d2b5eccccd7cddfa81144176a6d3c32f4670add5306f3a6ef78bc05244.webp)

Wanneer een van beide time-outs verloopt, stuurt ElevenAgents het geconfigureerde bericht ***Maximale gespreksduur*** voordat het gesprek wordt gesloten. Als het bericht leeg is, wordt het gesprek zonder afscheid gesloten.

De agent begrijpt meer dan alleen platte tekst:

* **Geciteerde reacties** — wanneer de gebruiker een bericht lang ingedrukt houdt en erop reageert, weet de agent op welk bericht diegene reageert.
* **Reacties** — emoji-reacties op de berichten van de agent worden doorgegeven aan de agent.
* **Tik op templateknoppen** — wanneer de gebruiker op een snelantwoordknop in een template tikt, ziet de agent welke knop is gekozen.
* **Interactieve reacties** — tikken op [interactieve knoppen en lijsten](/docs/nl/eleven-agents/whatsapp/interactive-messages) komen binnen met de geselecteerde optie.

> **Note**
>
> De agent reageert afzonderlijk op elk inkomend bericht. Snelle opeenvolgende berichten worden niet
> gebundeld in één reactie.

### Uitgaand

Je kunt een gesprek starten door vanuit het dashboard of de API een door Meta goedgekeurde berichttemplate te versturen, en uitgaande gesprekken plannen met een verzoek om gesprekstoestemming. Zie [Uitgaande berichten en templates](/docs/nl/eleven-agents/whatsapp/outbound) voor het maken van templates, codevoorbeelden, regels voor de indeling van ontvangers en batchcampagnes.

### Berichttypen

Naast tekst kun je ook het volgende versturen:

* audio
  * Inkomende spraakberichten worden naar tekst getranscribeerd voordat ze aan de agent worden doorgegeven.
  * Standaard beantwoordt de agent spraakberichten met spraakberichten, gegenereerd met de geconfigureerde stem van de agent — elke stem, elke taal. Schakel ***Reactie op audioberichten inschakelen*** uit in de accountinstellingen om altijd met tekst te reageren. Als het genereren van audio mislukt, valt de agent terug op een tekstreactie.
  * Audioberichten brengen extra kosten voor spraak-naar-tekst en tekst-naar-spraak met zich mee. De prijzen zijn hetzelfde als in de STT- en TTS-API's.
* afbeelding
* document
* sticker
* locatie
* contact

![WhatsApp-audiogesprek](/docs/_fern-img/372158bc0f86d62b6742f2bb44a741e5299ee7b95e36e38c3df1f9c06cffe2a0.webp)![WhatsApp-afbeeldingsgesprek](/docs/_fern-img/cbfbadb9d0a20f35537ce3bd137eb12b1005a862a7e1cf0155d271502fb713da.webp)![WhatsApp-documentgesprek](/docs/_fern-img/2b91d4077ac19a56dda9c5c016a47ed7d574ba2cb77ac89eb8785925bc89fa13.webp)![WhatsApp-locatiegesprek](/docs/_fern-img/bcd0d8f7df69d6c381be5be7c7a91ec7752b2b1894a80539823b7d9266beb3dd.webp)![WhatsApp-contactengesprek](/docs/_fern-img/75e56544700c87817a7f842943301a95e9e0b1fb84fc87e19139adb77f49ea5a.webp)

## Gesprekken

### Inkomend

Je kunt je WhatsApp-bedrijfsaccount bellen en de agent reageert. Tijdens het gesprek kun je ook tekstberichten sturen; deze worden in het gesprek opgenomen.

### Uitgaand

Voor uitgaande gesprekken is toestemming van de gebruiker vereist, die je via een template aanvraagt. Zie [een uitgaand gesprek plannen](/docs/nl/eleven-agents/whatsapp/outbound#scheduling-an-outbound-call) voor de stroom, codevoorbeelden en bellen in batches.

## Personalisatie

We stellen de [dynamische variabelen](/docs/nl/eleven-agents/customization/personalization/dynamic-variables) `{{system__caller_id}}` en `{{system__called_number}}` in op de WhatsApp-gebruikers-ID en je WhatsApp-telefoonnummer-ID (of omgekeerd, afhankelijk van wie het gesprek is gestart). Je kunt deze in een tool of een [webhook voor gespreksinitiatie](/docs/nl/eleven-agents/customization/personalization#conversation-initiation-webhooks) gebruiken om informatie over je gebruiker in het gesprek op te halen.

> **Info**
>
> Je vindt je WhatsApp-telefoonnummer-ID door naar de [WhatsApp-pagina](https://elevenlabs.io/app/agents/whatsapp) te gaan, op het menu naast je account te klikken en ***Telefoonnummer-ID kopiëren*** te selecteren.

### Initialisatiecontext

Als je agent naast de bovenstaande systeemvariabelen ook [dynamische variabelen](/docs/nl/eleven-agents/customization/personalization/dynamic-variables) gebruikt, moet je plannen waar de waarden hiervoor vandaan komen. Als je agent geen dynamische variabelen gebruikt, is dit niet van toepassing.

**Inkomende gesprekken** beginnen zonder door de gebruiker opgegeven dynamische variabelen. De ondersteunde manier om waarden op te geven is een [webhook voor gespreksinitiatie](/docs/nl/eleven-agents/customization/personalization#conversation-initiation-webhooks): wanneer een WhatsApp-bericht een gesprek start, roept ElevenAgents je endpoint aan met de WhatsApp-gebruikers-ID als `caller_id` en je WhatsApp-telefoonnummer-ID als `called_number`, en past het de dynamische variabelen toe die je reactie retourneert. Zorg dat de webhook altijd elke variabele retourneert die de agent vereist — een CRM-waarde wanneer je die hebt, anders een terugvalconstante.

> **Warning**
>
> De waarden die je onder **Dynamische variabelen** in de agenteditor invoert, zijn testplaceholders om
> een preview van de agent te bekijken. Ze worden niet gebruikt in productie en dienen niet als standaardwaarden voor inkomende
> gesprekken.

**Uitgaande gesprekken** ontvangen hun waarden uit het veld `conversation_initiation_client_data.dynamic_variables` van het [verzoek voor een uitgaand bericht of gesprek](/docs/nl/eleven-agents/whatsapp/outbound#dynamic-variables-branches-and-environments). Deze waarden blijven voor het gesprek behouden en zijn nog steeds beschikbaar wanneer de gebruiker reageert. Templateparameters zijn een afzonderlijk veld en vullen geen dynamische variabelen in.

Een vereiste variabele zonder waarde zorgt ervoor dat het gesprek mislukt. Zie [ontbrekende dynamische variabelen](/docs/nl/eleven-agents/whatsapp/troubleshooting#the-agent-doesnt-respond-to-inbound-messages) in de probleemoplossingshandleiding.

> **Note**
>
> De waarde `system__called_number` is je WhatsApp-**telefoonnummer-ID**, niet het telefoonnummer zelf.
> WhatsApp-gebruikers-ID's migreren ook naar [Business-Scoped User IDs (BSUIDs)](https://developers.facebook.com/documentation/business-messaging/whatsapp/business-scoped-user-ids);
> ElevenAgents ondersteunt BSUID's, zodat gesprekken werken, zelfs wanneer Meta een ID verstrekt in plaats van het
> telefoonnummer van de gebruiker.

## Beperkingen

Het volgende wordt momenteel niet ondersteund:

* **WhatsApp Flows** — interactieve formulieren kunnen niet worden verstuurd en Flow-reacties worden niet aan de agent doorgegeven.
* **Videoberichten** — inkomende video's worden niet aan de agent doorgegeven.
* **Berichten bundelen** — de agent reageert afzonderlijk op elk bericht in plaats van snelle opeenvolgende berichten samen te voegen.
* **Nummers die door een andere provider worden beheerd** — een nummer dat bij een andere WhatsApp-provider is geregistreerd of actief is in de WhatsApp Business-app, kan niet worden geïmporteerd. We werken met Meta aan het mogelijk maken van [Multi-Solution Conversations](https://developers.facebook.com/documentation/business-messaging/whatsapp/solution-providers/multi-solution-conversations); configuraties met alleen spraak zijn mogelijk al via SIP mogelijk (zie de [FAQ](/docs/nl/eleven-agents/whatsapp/troubleshooting#faq)).
* **WABA's die onder een ontwikkelaarsapp zijn gemaakt** — deze kunnen niet via de standaardstroom worden geïmporteerd.
* **Metagegevens van advertentieverwijzingen** — attributiegegevens van Click-to-WhatsApp-advertenties worden niet beschikbaar gesteld aan de agent (zie de [FAQ](/docs/nl/eleven-agents/whatsapp/troubleshooting#faq)).
* **Overdracht aan een medewerker** — komt binnenkort (zie de [FAQ](/docs/nl/eleven-agents/whatsapp/troubleshooting#faq)).

## FAQ

Veelgestelde vragen over prijzen, configuraties met meerdere providers, overdracht aan een medewerker, Zero-Retention Mode, OTP en compliance worden beantwoord in [Probleemoplossing en FAQ](/docs/nl/eleven-agents/whatsapp/troubleshooting).