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

# Pierwsze kroki

## Co zbudujesz

Po tym przewodniku twój agent będzie odpowiadać na wiadomości tekstowe i głosowe WhatsApp na numerze firmowym, a ty wyślesz jedną wiadomość szablonową przez API. Zajmie to około 20 minut, plus krótki czas oczekiwania na zatwierdzenie pierwszego szablonu przez Meta.

## Zanim zaczniesz

Potrzebujesz:

* [agenta ElevenLabs](/docs/pl/eleven-agents/quickstart). Wystarczy dowolny istniejący agent.
* [portfela firmowego Meta](https://business.facebook.com/), którym możesz zarządzać.
* Numeru telefonu, który **nie** jest obecnie używany w aplikacji WhatsApp Business ani zarejestrowany u innego dostawcy WhatsApp. Numerów używanych gdzie indziej nie można importować — zobacz [Ograniczenia](/docs/pl/eleven-agents/whatsapp#limitations).
* Metody płatności w [Menedżerze WhatsApp](https://business.facebook.com/latest/whatsapp_manager/), jeśli planujesz wysyłać szablony lub dzwonić. Meta rozlicza je osobno, niezależnie od ElevenLabs.

#### Zaimportuj konto firmowe WhatsApp

Wejdź na [stronę WhatsApp](https://elevenlabs.io/app/agents/whatsapp) i kliknij przycisk ***Importuj konto***. Otworzy się proces autoryzacji Meta, w którym wybierzesz (lub utworzysz) konto firmowe WhatsApp i numer telefonu oraz nadasz ElevenLabs uprawnienia do zarządzania nimi:

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

#### Przypisz agenta i wybierz zachowanie

Po imporcie przejdziesz na stronę ustawień konta. Przypisz agenta — dopóki tego nie zrobisz, wiadomości przychodzące będą ignorowane, a połączenia przychodzące odrzucane:

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

Ustaw zachowanie agenta dla tego numeru (pełny opis znajdziesz w [ustawieniach konta](/docs/pl/eleven-agents/whatsapp#account-settings)):

* **Włącz wiadomości** — określa, czy agent w ogóle odpowiada na wiadomości. Wyłącz tę opcję, jeśli wiadomości obsługuje inny system, a ElevenLabs ma obsługiwać tylko połączenia.
* **Włącz odpowiedzi na wiadomości głosowe** — gdy opcja jest włączona, agent odpowiada na wiadomości głosowe wiadomościami głosowymi własnym głosem; gdy jest wyłączona, zawsze odpowiada tekstem.
* **Włącz wskaźnik pisania** — gdy opcja jest włączona, agent oznacza wiadomości przychodzące jako przeczytane i wyświetla wskaźnik pisania podczas pracy.

#### Przeprowadź pierwszą rozmowę

Napisz na swój numer firmowy z prywatnego telefonu. Agent odpowie. Wyślij wiadomość głosową — zostanie transkrybowana dla agenta, a agent odpowie własną wiadomością głosową:

![Rozmowa tekstowa w WhatsApp](/docs/_fern-img/4c31b4d2b5eccccd7cddfa81144176a6d3c32f4670add5306f3a6ef78bc05244.webp)

Rozmowa będzie pojawiać się w [historii rozmów](https://elevenlabs.io/app/agents/history) na bieżąco.

> **Info**
>
> Rozmowa przez wiadomości kończy się, gdy agent użyje narzędzia systemowego ***Zakończ rozmowę***,
> minie ***Maksymalny czas trwania rozmowy*** albo po ostatniej odpowiedzi agenta upłynie
> domyślny 15-minutowy limit bezczynności. Kolejna wiadomość użytkownika rozpoczyna nową
> rozmowę. Więcej informacji o [limitach czasu rozmów](/docs/pl/eleven-agents/customization/conversation-flow#maximum-conversation-duration).

#### Wyślij pierwszą wiadomość wychodzącą

Aby pierwszym napisać do użytkownika, potrzebujesz zatwierdzonego przez Meta **szablonu wiadomości** — WhatsApp pozwala firmom wysyłać dowolne wiadomości tylko w aktywnej rozmowie. Utwórz prosty szablon Utility w [Menedżerze WhatsApp](https://business.facebook.com/latest/whatsapp_manager/message_templates), na przykład:

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

Gdy szablon zostanie zatwierdzony, wyślij go:

#### 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"
  }'
```

Ważne są tu dwie rzeczy:

* `template_params` to lista obiektów komponentów — opakowanie `{"type": "body", ...}` jest wymagane.
* `whatsapp_user_id` zawiera wyłącznie cyfry, z kodem kraju i bez `+` (na przykład `14155552671`).

Znajdź swój `whatsapp_phone_number_id` na [stronie WhatsApp](https://elevenlabs.io/app/agents/whatsapp), wybierając w menu konta opcję ***Kopiuj identyfikator numeru telefonu***.

Twój telefon otrzyma szablon. Odpowiedz na niego — agent przejmie rozmowę od tego momentu.

## Jeśli coś nie zadziałało

* **Agent nigdy nie odpowiada**: do numeru nie przypisano agenta albo opcja **Włącz wiadomości** jest wyłączona. Jeśli wszystko wygląda poprawnie, sprawdź, czy agent wymaga [zmiennych dynamicznych](/docs/pl/eleven-agents/customization/personalization/dynamic-variables) — przychodząca rozmowa WhatsApp zaczyna się bez wartości podanych przez użytkownika, więc agent, którego narzędzia lub pierwsza wiadomość wymagają takiej wartości, nie odpowie, chyba że dostarczy ją webhook inicjujący rozmowę. Zobacz [kontekst inicjalizacji](/docs/pl/eleven-agents/whatsapp#initialization-context).
* **Import się nie udaje**: numer jest już zarejestrowany u innego dostawcy lub w aplikacji WhatsApp Business.
* **API zwróciło 200, ale wiadomość nie dotarła**: szablon nie został jeszcze zatwierdzony, parametry nie pasują do szablonu albo twoje konto firmowe WhatsApp ma nierozliczone płatności (błąd Meta 131042).
* **Odpowiedź użytkownika rozpoczęła osobną rozmowę bez kontekstu**: format identyfikatora odbiorcy był nieprawidłowy — zobacz [format numeru odbiorcy](/docs/pl/eleven-agents/whatsapp/outbound#recipient-number-format).

W pozostałych przypadkach zobacz [Rozwiązywanie problemów i FAQ](/docs/pl/eleven-agents/whatsapp/troubleshooting).

## Kolejne kroki

* Personalizuj rozmowy za pomocą [zmiennych dynamicznych](/docs/pl/eleven-agents/whatsapp/outbound#dynamic-variables-branches-and-environments) i [systemowych zmiennych personalizacji](/docs/pl/eleven-agents/whatsapp#personalization).
* Prowadź działania na dużą skalę dzięki [wiadomościom wychodzącym i szablonom](/docs/pl/eleven-agents/whatsapp/outbound).
* Pozwól agentowi oferować wybory do kliknięcia dzięki [wiadomościom interaktywnym](/docs/pl/eleven-agents/whatsapp/interactive-messages).
* Wysyłaj wiadomości WhatsApp z agentów na innych kanałach za pomocą [narzędzi WhatsApp](/docs/pl/eleven-agents/whatsapp/tools).
* Poznaj koszty w [FAQ o cenach](/docs/pl/eleven-agents/whatsapp/troubleshooting#faq).