Hoppa till navigering

Kom igång

Anslut ditt WhatsApp-nummer till en agent och skicka ditt första utgående meddelande

Det här bygger du

När du har gått igenom den här guiden kan din agent besvara WhatsApp-textmeddelanden och röstmeddelanden på ditt företagsnummer, och du har skickat ett API-initierat mallmeddelande. Räkna med cirka 20 minuter, plus en kort väntan medan Meta godkänner din första mall.

Innan du börjar

Du behöver:

  • En ElevenLabs-agent. Vilken befintlig agent som helst fungerar.
  • En Meta-företagsportfölj som du kan administrera.
  • Ett telefonnummer som inte används i WhatsApp Business-appen eller är registrerat hos en annan WhatsApp-leverantör. Nummer som används på annat håll kan inte importeras — se Begränsningar.
  • En betalningsmetod i WhatsApp Manager om du planerar att skicka mallar eller ringa samtal. Meta fakturerar dessa separat från ElevenLabs.
1

Importera ditt WhatsApp Business-konto

Gå till WhatsApp-sidan och klicka på knappen Importera konto. Då öppnas Metas auktoriseringsflöde, där du väljer (eller skapar) WhatsApp Business-kontot och telefonnumret samt ger ElevenLabs behörighet att hantera det:

Auktoriseringsflöde för WhatsApp
2

Tilldela din agent och välj beteenden

Efter importen hamnar du på sidan för kontoinställningar. Tilldela en agent — tills du gör det ignoreras inkommande meddelanden och inkommande samtal avvisas:

WhatsApp-kontosida

Konfigurera hur agenten beter sig på det här numret (se kontoinställningar för hela referensen):

  • Aktivera meddelanden — om agenten alls ska svara på meddelanden. Stäng av detta om ett annat system hanterar meddelanden och ElevenLabs bara ska hantera samtal.
  • Aktivera svar på ljudmeddelanden — när detta är aktiverat svarar agenten på röstmeddelanden med röstmeddelanden med sin egen röst; när det är avstängt svarar den alltid med text.
  • Aktivera skrivindikator — när detta är aktiverat markerar agenten inkommande meddelanden som lästa och visar en skrivindikator medan den arbetar.
3

Ha ditt första samtal

Skicka ett meddelande till ditt företagsnummer från en privat telefon. Agenten svarar. Skicka ett röstmeddelande — det transkriberas för agenten, som svarar med ett eget röstmeddelande:

WhatsApp-textkonversation

Konversationen visas i din konversationshistorik medan den pågår.

En meddelandekonversation avslutas när agenten använder systemverktyget Avsluta konversation, Maximal konversationslängd löper ut eller standardtidsgränsen på 15 minuters inaktivitet passerar efter agentens senaste svar. Användarens nästa meddelande startar en ny konversation. Läs mer om tidsgränser för konversationer.

4

Skicka ditt första utgående meddelande

För att kontakta en användare först krävs en Meta-godkänd meddelandemall — WhatsApp tillåter bara fritt formulerade företagsmeddelanden i en aktiv konversation. Skapa en enkel verktygsmall i WhatsApp Manager, till exempel:

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

När mallen har godkänts skickar du den:

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",
)

Två detaljer är viktiga här:

  • template_params är en lista med komponentobjekt — omslutningen {"type": "body", ...} krävs.
  • whatsapp_user_id innehåller endast siffror, med landskod och utan + (till exempel 14155552671).

Du hittar ditt whatsapp_phone_number_id på WhatsApp-sidan via alternativet Kopiera telefonnummer-ID i kontomenyn.

Din telefon tar emot mallen. Svara på den — agenten tar över konversationen därifrån.

Om något inte fungerade

  • Agenten svarar aldrig: ingen agent har tilldelats numret, eller så är Aktivera meddelanden avstängt. Om det verkar stämma kontrollerar du om agenten kräver dynamiska variabler — en inkommande WhatsApp-konversation startar utan värden som angetts av användaren, så en agent vars verktyg eller första meddelande kräver ett sådant värde misslyckas innan den svarar, om inte en webhook för konversationsinitiering tillhandahåller det. Se initialiseringskontext.
  • Importen misslyckas: numret är redan registrerat hos en annan leverantör eller i WhatsApp Business-appen.
  • API:et returnerade 200 men inget meddelande kom fram: mallen är ännu inte godkänd, parametrarna matchar inte mallen eller så har ditt WhatsApp Business-konto obetalda fakturor (Meta-fel 131042).
  • Användarens svar startade en separat konversation utan kontext: mottagar-ID:ts format var fel — se format för mottagarnummer.

För allt annat, se Felsökning och vanliga frågor.

Nästa steg