API czatu (odpowiedzi)

Spis treści

  1. Auth
  2. Endpoint
  3. Uwagi
  4. Zobacz też

Kierunek inbound: Twój system (własne AI, Make, n8n, backend) wysyła odpowiedź na czat w pokoju webinaru.

Dostęp: funkcja jest w early access. Włączamy ją na koncie przez support Webivio (whitelist jak Live). Bez grantu endpoint zwraca 403, a event webinar.chat.message nie jest dostępny w ustawieniach webhooków.

Typowy przepływ z AI:

  1. Webivio emituje outbound webhook webinar.chat.message (treść + message_id + dane uczestnika).
  2. Twój serwis generuje odpowiedź.
  3. Wywołujesz ten endpoint z tokenem konta wvapi_….

Token jest ten sam co w API statystyk: Ustawienia → API (tokeny).

Auth

Authorization: Bearer wvapi_YOUR_TOKEN

albo

X-Api-Key: wvapi_YOUR_TOKEN

Endpoint

POST /api/public/v1/webinars/{webinarId}/chat/reply
Content-Type: application/json

Body — odpowiedź prywatna

Widoczna tylko dla uczestnika, którego dotyczy wiadomość z webhooka:

{
  "text": "Dziękujemy za pytanie — zaraz odpowiemy w nagraniu.",
  "visibility": "private",
  "replyToMessageId": "uuid-z-webhooka-data.message_id"
}

Body — odpowiedź publiczna

Jak wiadomość moderatora do uczestników (broadcast):

{
  "text": "Witamy na webinarze!",
  "visibility": "public"
}
PoleWymaganeOpis
texttak1–4000 znaków
visibilitytak"private" albo "public"
replyToMessageIdprzy privateUUID wiadomości uczestnika (data.message_id z webhooka)

Odpowiedzi

Prywatna:

{ "ok": true, "mode": "reply", "messageId": "…" }

Publiczna:

{ "ok": true, "mode": "broadcast", "inserted": 42 }

Błędy typowe: 401 (token), 404 (webinar / wiadomość), 400 (walidacja / brak uczestników), 429 (rate limit).

Uwagi

  • Odpowiedzi z tego API nie generują ponownie webinar.chat.message.
  • Eksport historii czatu: panel Wiadomości z czatu (CSV/TXT) — publiczne API listy wiadomości na razie niedostępne.
  • Limit requestów: jak Stats API (~60/min, ~600/h na token).

Zobacz też