> 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.

# Kom igång

## 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](/docs/sv/eleven-agents/quickstart). Vilken befintlig agent som helst fungerar.
* En [Meta-företagsportfölj](https://business.facebook.com/) 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](/docs/sv/eleven-agents/whatsapp#limitations).
* En betalningsmetod i [WhatsApp Manager](https://business.facebook.com/latest/whatsapp_manager/) om du planerar att skicka mallar eller ringa samtal. Meta fakturerar dessa separat från ElevenLabs.

#### Importera ditt WhatsApp Business-konto

Gå till [WhatsApp-sidan](https://elevenlabs.io/app/agents/whatsapp) 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](/docs/_fern-img/9e5238e98f926582db314e9debc187a7dc29fd38a980cb732b4563b373110351.webp)

#### 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](/docs/_fern-img/f5598ac70ade00048effb5ee3bf6cbc93cd61876652eb3ce5917ac21c6209bf6.webp)

Konfigurera hur agenten beter sig på det här numret (se [kontoinställningar](/docs/sv/eleven-agents/whatsapp#account-settings) 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.

#### 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](/docs/_fern-img/4c31b4d2b5eccccd7cddfa81144176a6d3c32f4670add5306f3a6ef78bc05244.webp)

Konversationen visas i din [konversationshistorik](https://elevenlabs.io/app/agents/history) medan den pågår.

> **Info**
>
> 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](/docs/sv/eleven-agents/customization/conversation-flow#maximum-conversation-duration).

#### 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](https://business.facebook.com/latest/whatsapp_manager/message_templates), till exempel:

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

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

#### Python

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

#### TypeScript

```typescript
import { ElevenLabsClient } from "@elevenlabs/elevenlabs-js";

const elevenlabs = new ElevenLabsClient();

await elevenlabs.conversationalAi.whatsapp.outboundMessage({
  whatsappPhoneNumberId: "524029457612345",
  whatsappUserId: "12213231492",
  templateName: "welcome",
  templateLanguageCode: "en",
  templateParams: [
    {
      type: "body",
      parameters: [{ type: "text", parameterName: "name", text: "Daniele" }],
    },
  ],
  agentId: "agent_9201kwcrbq9qfxaa2t8nnnkqf2w9",
});
```

#### cURL

```bash
curl -X POST https://api.elevenlabs.io/v1/convai/whatsapp/outbound-message \
  -H "xi-api-key: $ELEVENLABS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "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](https://elevenlabs.io/app/agents/whatsapp) 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](/docs/sv/eleven-agents/customization/personalization/dynamic-variables) — 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](/docs/sv/eleven-agents/whatsapp#initialization-context).
* **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](/docs/sv/eleven-agents/whatsapp/outbound#recipient-number-format).

För allt annat, se [Felsökning och vanliga frågor](/docs/sv/eleven-agents/whatsapp/troubleshooting).

## Nästa steg

* Anpassa konversationer med [dynamiska variabler](/docs/sv/eleven-agents/whatsapp/outbound#dynamic-variables-branches-and-environments) och [systemvariabler för personalisering](/docs/sv/eleven-agents/whatsapp#personalization).
* Genomför kontaktkampanjer i stor skala med [utgående meddelanden och mallar](/docs/sv/eleven-agents/whatsapp/outbound).
* Låt agenten erbjuda val som går att trycka på med [interaktiva meddelanden](/docs/sv/eleven-agents/whatsapp/interactive-messages).
* Skicka WhatsApp-meddelanden från agenter på andra kanaler med [WhatsApp-verktyg](/docs/sv/eleven-agents/whatsapp/tools).
* Förstå kostnaderna i [vanliga frågor om priser](/docs/sv/eleven-agents/whatsapp/troubleshooting#faq).