Skip to navigation
ImplementerenWhatsApp

Aan de slag

Koppel je WhatsApp-nummer aan een agent en verstuur je eerste uitgaande bericht

Wat je gaat bouwen

Aan het einde van deze handleiding beantwoordt je agent WhatsApp-tekstberichten en spraakberichten op je zakelijke nummer, en heb je één via de API gestart templatebericht verstuurd. Reken op ongeveer 20 minuten, plus een korte wachttijd totdat Meta je eerste template goedkeurt.

Voordat je begint

Je hebt nodig:

  • Een ElevenLabs-agent. Elke bestaande agent werkt.
  • Een Meta-bedrijfsportfolio dat je kunt beheren.
  • Een telefoonnummer dat niet momenteel wordt gebruikt in de WhatsApp Business-app of is geregistreerd bij een andere WhatsApp-provider. Nummers die elders in gebruik zijn, kunnen niet worden geïmporteerd — zie Beperkingen.
  • Een betaalmethode in WhatsApp Manager als je templates wilt versturen of bellen. Meta factureert deze apart van ElevenLabs.
1

Importeer je WhatsApp-bedrijfsaccount

Ga naar de WhatsApp-pagina en klik op de knop Account importeren. Hiermee open je de autorisatieflow van Meta, waarin je het WhatsApp-bedrijfsaccount en telefoonnummer selecteert (of maakt) en ElevenLabs toestemming geeft om deze te beheren:

WhatsApp-autorisatieflow
2

Wijs je agent toe en kies het gedrag

Na het importeren kom je op de pagina met accountinstellingen terecht. Wijs een agent toe — totdat je dat doet, worden inkomende berichten genegeerd en inkomende gesprekken geweigerd:

WhatsApp-accountpagina

Stel in hoe de agent zich op dit nummer gedraagt (zie accountinstellingen voor de volledige referentie):

  • Messaging inschakelen — of de agent überhaupt op berichten reageert. Schakel dit uit als een ander systeem berichten afhandelt en ElevenLabs alleen gesprekken moet afhandelen.
  • Reactie op audioberichten inschakelen — wanneer dit is ingeschakeld, beantwoordt de agent spraakberichten met spraakberichten in zijn eigen stem; wanneer het is uitgeschakeld, reageert hij altijd met tekst.
  • Type-indicator inschakelen — wanneer dit is ingeschakeld, markeert de agent inkomende berichten als gelezen en toont hij een type-indicator terwijl hij werkt.
3

Voer je eerste gesprek

Stuur vanaf een persoonlijke telefoon een bericht naar je zakelijke nummer. De agent reageert. Stuur een spraakbericht — dit wordt voor de agent getranscribeerd en de agent reageert met een eigen spraakbericht:

WhatsApp-tekstgesprek

Het gesprek verschijnt terwijl het plaatsvindt in je gespreksgeschiedenis.

Een berichtengesprek eindigt wanneer de agent de systeemtool Gesprek beëindigen gebruikt, de Maximale gespreksduur verstrijkt of de standaardtime-out van 15 minuten inactiviteit verstrijkt na de meest recente reactie van de agent. Het volgende bericht van de gebruiker start een nieuw gesprek. Lees meer over gesprekstime-outs.

4

Verstuur je eerste uitgaande bericht

Als je als eerste contact opneemt met een gebruiker, heb je een door Meta goedgekeurde berichttemplate nodig — WhatsApp staat vrij geformuleerde zakelijke berichten alleen toe binnen een actief gesprek. Maak bijvoorbeeld een eenvoudige Utility-template in WhatsApp Manager:

Hi {{name}}, thanks for signing up. Reply here if you have any questions.

Verstuur de template zodra deze is goedgekeurd:

from elevenlabs import ElevenLabs
elevenlabs = ElevenLabs()
elevenlabs.conversational_ai.whatsapp.outbound_message(
    whatsapp_phone_number_id="524029457612345",
    whatsapp_user_id="12213231492",
    template_name="welcome",
    template_language_code="en",
    template_params=[
        {
            "type": "body",
            "parameters": [
                {"type": "text", "parameter_name": "name", "text": "Daniele"}
            ],
        }
    ],
    agent_id="agent_9201kwcrbq9qfxaa2t8nnnkqf2w9",
)

Twee details zijn hier belangrijk:

  • template_params is een lijst met componentobjecten — de wrapper {"type": "body", ...} is vereist.
  • whatsapp_user_id bevat alleen cijfers, inclusief landcode en zonder + (bijvoorbeeld 14155552671).

Je vindt je whatsapp_phone_number_id op de WhatsApp-pagina via de optie Telefoonnummer-ID kopiëren in het accountmenu.

Je telefoon ontvangt de template. Reageer erop — de agent pakt het gesprek vanaf daar op.

Als iets niet werkte

  • De agent reageert nooit: er is geen agent aan het nummer toegewezen of Messaging inschakelen staat uit. Als dat correct lijkt, controleer dan of de agent dynamische variabelen vereist — een inkomend WhatsApp-gesprek start zonder door de gebruiker opgegeven waarden, dus een agent waarvan de tools of het eerste bericht er een vereisen, mislukt vóór hij reageert, tenzij een webhook voor gespreksinitiatie deze levert. Zie initialisatiecontext.
  • Het importeren mislukt: het nummer is al geregistreerd bij een andere provider of in de WhatsApp Business-app.
  • De API retourneerde 200, maar er kwam geen bericht aan: de template is nog niet goedgekeurd, de parameters komen niet overeen met de template, of je WhatsApp-bedrijfsaccount heeft openstaande betalingen (Meta-fout 131042).
  • De reactie van de gebruiker startte een afzonderlijk gesprek zonder context: de indeling van de ontvanger-ID klopte niet — zie indeling van ontvangersnummer.

Zie voor al het andere Probleemoplossing en veelgestelde vragen.

Volgende stappen