ElevenLabs

Agent Panel osadza widget ElevenLabs Conversational AI, dzięki czemu użytkownik może porozmawiać głosowo z agentem sprzedażowym, który sprawdza katalog produktów i finalizuje płatność BLIK - bez wpisywania czegokolwiek w interfejsie.

1. Osadzenie widgetu

W aplikacji ładowany jest skrypt embed ElevenLabs, a widget montowany jest z dynamic-variables przekazującymi agentId portfela, do którego przypisana jest rozmowa:

<script src="https://unpkg.com/@elevenlabs/convai-widget-embed" async></script>

<elevenlabs-convai
  agent-id="<id-agenta-elevenlabs>"
  dynamic-variables='{"agentId":"<agentId-portfela>"}'
></elevenlabs-convai>

agentId trafia do agenta ElevenLabs jako zmienna dynamiczna i jest przekazywany dalej w każdym wywołaniu narzędzi płatniczych - to on wiąże rozmowę głosową z konkretnym portfelem.

To są dwa różne identyfikatory o podobnej nazwie - łatwo je pomylić:

agent-id (atrybut widgetu) - ID bota w ElevenLabs. Wskazuje, którą konfigurację agenta głosowego załadować (prompt, głos, narzędzia). Stała wartość, ta sama dla każdej rozmowy.
agentId (wewnątrz dynamic-variables) - identyfikator portfela Paymove (ten sam co w agentId transakcji/agenta w Agent Panel). Zmienia się w zależności od tego, kto otwiera czat, i to on trafia do process_blik_payment, żeby narzędzie wiedziało, z którego portfela zejść płatność.

2. Konfiguracja narzędzi (webhook tools)

W panelu ElevenLabs → agent → Narzędzia skonfiguruj trzy narzędzia webhook wskazujące na Twoje środowisko Agent Panel (np. https://<twoja-domena>):

`get_available_products`


Metoda	`GET`
URL	`/api/products`
Auth	brak - katalog jest publiczny

Zwraca listę produktów z id, name i price (w groszach).

`process_blik_payment`


Metoda	`POST`
URL	`/api/payments/blik`

Body (JSON):

Pole	Źródło	Opis
`agentId`	dynamic variable	Portfel, z którego realizowana jest płatność
`price`	z `get_available_products`	Cena w groszach - bez przeliczania na PLN
`email`	LLM / rozmowa	E-mail klienta
`authorizationCode`	LLM / rozmowa	6-cyfrowy kod BLIK podany przez klienta
`productId`	z `get_available_products`	Identyfikator produktu (potrzebny, żeby paragon miał nazwę produktu)

Odpowiedź:

{
  "continueUrl": "https://...",
  "externalId": "agent_123abc456",
  "txId": "blik_9f2e...",
  "amount": 3000,
  "currency": "PLN"
}

Ta odpowiedź nie zawiera jeszcze wyniku płatności - externalId służy wyłącznie do sprawdzenia statusu w kolejnym kroku. Agent nie powinien na tej podstawie ogłaszać sukcesu.

`check_payment_status`


Metoda	`GET`
URL	`/api/payments/blik/status`
Query param	`externalId` - zmienna dynamiczna, nie pytanie do LLM

Odpowiedź:

{ "status": "pending" | "completed" | "failed", "paymove": { "status": "...", "orderId": "..." } }

3. Przechwycenie `externalId` jako dynamic variable

externalId powstaje dopiero w odpowiedzi process_blik_payment, więc w konfiguracji tego narzędzia w sekcji przypisań (assignments) dodaj:

pole odpowiedzi externalId → zapisz jako dynamic variable, np. payment_external_id

Następnie w check_payment_status parametr externalId ustaw jako tę samą zmienną dynamiczną ({{payment_external_id}}), a nie jako podpowiedź LLM.

4. Kontrakt groszowy

Wszystkie kwoty w tych trzech narzędziach są w groszach (liczba całkowita, 30 zł = 3000). Cena pobrana z get_available_products trafia bez żadnej modyfikacji do process_blik_payment.price. To samo dotyczy pola amount w odpowiedzi - agent powinien podzielić je przez 100, żeby wypowiedzieć cenę klientowi w złotówkach.

W opisie parametru price w konfiguracji narzędzia process_blik_payment w panelu ElevenLabs upewnij się, że jest napisane wprost, że jednostką są grosze (np. “Cena w groszach - 30 zł należy wysłać jako 3000”). Sam opis w promptcie/systemie nie wystarczy, jeśli opis parametru narzędzia sugeruje PLN - LLM kieruje się przede wszystkim opisem pola.

5. System prompt - obsługa statusu

Dodaj do system promptu jednoznaczną instrukcję, że wynik płatności rozstrzyga wyłącznie pole status z check_payment_status, a nie sam fakt, że wywołanie się powiodło:

Po process_blik_payment ZAWSZE wywołuj check_payment_status, dopóki status nie przestanie
być "pending" (maks. 10 razy, co 2-3 sekundy). Nigdy nie informuj klienta o wyniku płatności
przed otrzymaniem statusu innego niż "pending".

- status "completed" → potwierdź klientowi sukces zakupu i podaj nazwę produktu oraz cenę.
- status "failed" → poinformuj klienta, że płatność się nie powiodła, zaproponuj podanie
  nowego kodu BLIK.
- status "pending" → powiedz, że płatność się przetwarza, i sprawdź ponownie.

Agent Panel niezależnie śledzi te same transakcje i wyświetla użytkownikowi wiadomości o postępie zakupu głosowego w czacie - check_payment_status w ElevenLabs jest potrzebny, żeby agent głosowy wiedział, co powiedzieć klientowi, a nie po to, żeby zainicjować samą płatność.

Wprowadzenie

Integracje

Tutoriale

Pomoc

1. Osadzenie widgetu

2. Konfiguracja narzędzi (webhook tools)

`get_available_products`

`process_blik_payment`

`check_payment_status`

3. Przechwycenie `externalId` jako dynamic variable

4. Kontrakt groszowy

5. System prompt - obsługa statusu

​1. Osadzenie widgetu

​2. Konfiguracja narzędzi (webhook tools)

​get_available_products

​process_blik_payment

​check_payment_status

​3. Przechwycenie externalId jako dynamic variable

​4. Kontrakt groszowy

​5. System prompt - obsługa statusu

1. Osadzenie widgetu

2. Konfiguracja narzędzi (webhook tools)

`get_available_products`

`process_blik_payment`

`check_payment_status`

3. Przechwycenie `externalId` jako dynamic variable

4. Kontrakt groszowy

5. System prompt - obsługa statusu