Integracje / Twilio i Vonage

Komunikacja, projekty i biuro

Integracja AI: Twilio i Vonage

Podłączamy konto Twilio albo Vonage przez API Key, Auth Token i webhook: asystent odbiera przychodzące SMS-y i wiadomości WhatsApp oraz sprawdza logi doręczeń z kodami błędów. Odpowiada klientom z bazy wiedzy, wysyła przypomnienia o wizytach i oznacza numery z błędem 30005 do weryfikacji.

Po prezentacji do 2 tygodni testów, z dostępem tego samego dnia. Płacicie dopiero po decyzji.

Narzędzie „Logi wiadomości Twilio i Vonage” w portalu redAi, ekran z danymi z programu Twilio i Vonage
Narzędzie „Logi wiadomości Twilio i Vonage” w Waszym portalu. Dane przykładowe.

W skrócie

Jak asystent AI łączy się z systemem Twilio i Vonage?

Łączymy się z Twilio przez Account SID i Auth Token widoczne w Twilio Console, a z Vonage przez API Key i API Secret z dashboardu. Webhook działający pod adresem HTTPS na serwerze klienta odbiera wiadomości przychodzące w trybie natychmiastowym.

Na start potrzebujemy
Account SID i Auth Token (Twilio) albo API Key i API Secret (Vonage) z panelu platformy.
Czego asystent nie robi
Nie wysyła wiadomości WhatsApp poza zatwierdzonym szablonem Meta bez potwierdzenia pracownika.
Gdzie są dane
Na Waszym serwerze. Zaczynamy od odczytu, zapis włączacie sami.

Dane z Twilio i Vonage w czacie i we własnym module

Pracujecie na dwa sposoby. W czacie pytacie o cokolwiek z programu i dostajecie odpowiedź na Waszych danych. Do rzeczy, które wracają co dzień, budujemy w portalu osobne narzędzie: Logi wiadomości Twilio i Vonage. Moduł zbiera statusy każdej wysłanej wiadomości SMS i WhatsApp z Waszych kont Twilio i Vonage i wyświetla je w jednym miejscu. Wasz opiekun klienta widzi od razu, które wiadomości dotarły, a które zwróciły kod błędu. Kliknięcie wiersza otwiera kartę z historią prób i sugestią asystenta dotyczącą kolejnego kroku.

  • Wyświetla statusy doręczeń ze wszystkich Waszych wiadomości SMS i WhatsApp z Twilio
  • Oznacza numery z błędem 30005 jako nieaktywne do weryfikacji przez Wasz zespół
  • Filtruje wiadomości przychodzące według kanału, kierunku i słów kluczowych
  • Pokazuje szablony WhatsApp Business czekające na zatwierdzenie przez Meta
  • Zapisuje logi połączeń głosowych: status, czas trwania i Recording SID
Rozmowa z asystentem AI w portalu redAi o danych z programu Twilio i Vonage: Szablony WhatsApp w statusie oczekiwania

Pytanie w czacie

Asystent pobiera stan każdego szablonu z Content API Twilio i wskazuje Wam te, które wstrzymują wysyłkę do klientów spoza aktywnego okna 24h.

Które szablony WhatsApp Business zarejestrowane w Twilio czekają na zatwierdzenie przez Meta i jak długo już czekają?
Karta +48 503 456 789 w narzędziu Logi wiadomości Twilio i Vonage w portalu redAi

Karta w narzędziu

Karta pokazuje Waszemu zespołowi pełną historię prób doręczenia dla jednego numeru: kody błędów Twilio z kolejnych wysyłek, źródło wpisu w bazie i sugestię asystenta dotyczącą kolejnego kroku.

Jeden ekran zamiast logowania do panelu Twilio i Vonage: Wasz opiekun klienta widzi statusy, kody błędów i kolejkę WhatsApp bez przełączania zakładek.

Ekrany na danych przykładowych. Narzędzie dla Waszej firmy układamy pod Wasz sposób pracy: inne kolumny, inne progi, inne powiadomienia.

Co podłączamy

Zaczynamy od odczytu danych. Zapis i akcje w systemie Twilio i Vonage włączamy dopiero wtedy, gdy sami tego chcecie.

Logi wiadomości SMS i WhatsApp

CzytamyPola from, to, body, status, error_code, direction, date_sent i price z endpointu GET /Messages.

AsystentGrupuje wiadomości według statusu doręczenia, wyciąga numery z błędami i generuje listę do weryfikacji.

Status callback doręczeń

CzytamyŻądanie POST z platformy przy każdej zmianie statusu: sent, delivered, undelivered albo failed.

AsystentWykrywa niedoręczone wiadomości i automatycznie próbuje kontaktu przez inny kanał albo dodaje zadanie do kalendarza pracownika.

Kody błędów wysyłki

CzytamyKody 30003, 30004, 30005 i 30008 z pola error_code przy każdej wiadomości o statusie undelivered.

AsystentKlasyfikuje błędy według kodu: oznacza numery 30005 do aktualizacji w bazie i eskaluje masowe błędy 30008 do weryfikacji u operatora.

Webhook wiadomości przychodzących

CzytamyTreść wiadomości, numer nadawcy i metadane z żądania POST wysyłanego przez platformę przy każdym nowym SMS albo wiadomości WhatsApp.

AsystentKlasyfikuje pytanie, dopasowuje odpowiedź z bazy wiedzy i przygotowuje ją do zatwierdzenia albo wysyła automatycznie dla prostych, powtarzalnych pytań.

Szablony WhatsApp Business

CzytamyLista szablonów zatwierdzonych przez Meta z polami zmiennymi: imię klienta, numer zamówienia, termin wizyty, kwota faktury.

AsystentWypełnia zmienne w szablonie danymi z CRM i wysyła wiadomość inicjowaną przez firmę poza oknem 24 godzin od ostatniego kontaktu.

Logi połączeń głosowych

CzytamyPola call_sid, duration, start_time, end_time, status i Recording SID z linkiem do pliku audio nagrania.

AsystentPobiera nagranie przez Recording SID, transkrybuje i analizuje przebieg rozmowy na potrzeby oceny obsługi albo wyciągania ustaleń.

Koszty wysyłki

CzytamyPola price i price_unit przy każdej wiadomości, widoczne w logach przez API.

AsystentSumuje koszty według okresu i numeru nadawcy, sygnalizuje wzrost wydatków powiązany z niedoręczonymi wiadomościami.

O co pytają w praktyce

Po polsku, jak koledze z pracy. Asystent odpowiada na danych z Waszego programu, a nie z ogólnej wiedzy.

  • „Które numery w bazie klientów mają status undelivered albo kod 30005?”
  • „Ile SMS-ów z przypomnień o wizytach zostało potwierdzone w tym tygodniu?”
  • „Jaka odpowiedź czeka na zatwierdzenie w kolejce wiadomości WhatsApp?”
  • „Do których klientów wiadomość SMS nie dotarła i co mamy teraz zrobić?”

Co się zmienia

Firma przestaje odpowiadać ręcznie na powtarzalne pytania SMS i WhatsApp, a niedoręczone wiadomości z nieaktualnymi numerami trafiają do weryfikacji zamiast ginąć w logach.

Asystent działa na Waszym serwerze, na Waszych uprawnieniach. Każdy odczyt i każda akcja zostawiają ślad w logu. Program zostaje tam, gdzie jest, razem z historią danych i nawykami zespołu.

O programie

Twilio i Vonage to platformy komunikacyjne działające w chmurze. Firma kupuje u nich numer telefonu albo rejestruje własny, a potem przez REST API wysyła SMS-y, odbiera wiadomości WhatsApp i inicjuje połączenia głosowe. Nie instalujecie niczego w biurze i płacicie za faktyczne zużycie. Twilio jest oficjalnym dostawcą BSP dla WhatsApp Business. Vonage, znany wcześniej jako Nexmo, jest powszechny w Europie i ma porównywalną funkcjonalność.

Na co dzień praca z platformą obejmuje trzy obszary: wysyłka i odbiór wiadomości tekstowych, obsługa WhatsApp Business z szablonami zatwierdzonymi przez Meta oraz logi połączeń głosowych z nagraniami. Wszystkie dane dostępne są przez REST API i panel Console (Twilio) albo Dashboard (Vonage). Nie ma dostępu do surowej bazy SQL, ale API daje wgląd w historię wiadomości, statusy doręczeń, kody błędów i koszty wysyłki.

Gdzie to działa najlepiej

Recepcjonistka gabinetu

Poniedziałek rano, kilkanaście wiadomości od pacjentów z prośbami o potwierdzenie, zmianę albo odwołanie wizyty nadesłanych przez weekend. Każda wymaga ręcznej odpowiedzi i wpisu w kalendarzu.

Z asystentem: Asystent klasyfikuje wiadomości, do prostych pytań o wolny termin przygotowuje odpowiedź do zatwierdzenia jednym kliknięciem, a prośby o zmianę trafiają od razu do rejestru zmian w kalendarzu.

Koordynator obsługi klienta

Firma wysyłała przez ostatni miesiąc kilkaset przypomnień SMS przez Twilio i nie wie, do ilu klientów wiadomości rzeczywiście dotarły. W logach są dziesiątki błędów, ale nikt ich dotąd nie przeglądał.

Z asystentem: Asystent pobiera logi z API, grupuje kody błędów i generuje gotową listę numerów z kodem 30005 do sprawdzenia przed następną wysyłką.

Właściciel firmy serwisowej

Kilku klientów nie zapłaciło faktur z terminem w tym tygodniu i nie odpowiedziało na pierwsze przypomnienie SMS wysłane przez Vonage trzy dni temu.

Z asystentem: Asystent wysyła drugą wiadomość z przypomnieniem, a brak reakcji po kolejnych dniach trafia jako zadanie do właściwej osoby z notatką o konieczności kontaktu.

Jak się łączymy

Łączymy się z Twilio przez Account SID i Auth Token widoczne w Twilio Console, a z Vonage przez API Key i API Secret z dashboardu. Webhook działający pod adresem HTTPS na serwerze klienta odbiera wiadomości przychodzące w trybie natychmiastowym. Dane historyczne pobieramy żądaniami GET do REST API w trybie odczytu, bez modyfikacji po stronie platformy.

Zapis odbywa się wyłącznie po potwierdzeniu przez pracownika: wysyłka wiadomości, oznaczenie numeru do weryfikacji albo dodanie zadania. Portal z bazą wiadomości stoi na serwerze klienta. Do modelu AI trafia treść wiadomości i fragment bazy wiedzy potrzebny do przygotowania odpowiedzi. Połączenie z API szyfrowane przez HTTPS. Dane uwierzytelniające przechowujemy zaszyfrowane i nie pojawiają się w logach ani kodzie.

Czego potrzebujemy od Was

  • Account SID i Auth Token (Twilio) albo API Key i API Secret (Vonage) z panelu platformy.
  • Numer telefonu zakupiony albo zarejestrowany na platformie Twilio albo Vonage.
  • Konto w Meta Business Manager z zweryfikowaną firmą: wymagane do WhatsApp Business API.
  • Adres HTTPS na serwerze klienta do skonfigurowania jako webhook w Twilio albo Vonage.
  • Osoba po stronie firmy odpowiedzialna za prowadzenie i aktualizację bazy wiedzy asystenta.

Czego asystent nie robi

  • Nie wysyła wiadomości WhatsApp poza zatwierdzonym szablonem Meta bez potwierdzenia pracownika.
  • Nie aktualizuje danych kontaktowych w CRM ani bazie firmy bez potwierdzenia: pokazuje, co wymaga korekty.
  • Nie podejmuje decyzji o windykacji ani eskalacji prawnej: wyłapuje brak reakcji i przekazuje do właściwej osoby.
  • Nie zmienia ustawień numerów, webhooków ani szablonów bezpośrednio w panelu Twilio albo Vonage.

Częste pytania

Czy możemy użyć numeru, który już mamy, zamiast kupować nowy?

Obie platformy obsługują portowanie numerów: przenosicie własny numer do Twilio albo Vonage. Trwa to zwykle kilka dni roboczych i wymaga zgody aktualnego operatora. Na czas przenoszenia możecie tymczasowo korzystać z numeru wirtualnego z platformy, żeby nie przerywać obsługi klientów podczas zmiany.

Co się dzieje z wiadomościami, które przychodzą poza godzinami pracy?

Webhook odbiera wiadomość od razu, niezależnie od pory. Asystent klasyfikuje ją i przygotowuje odpowiedź, która trafia do kolejki dla pracownika albo, dla prostych pytań, idzie automatycznie. Możecie skonfigurować automatyczną odpowiedź informującą klienta o godzinach, kiedy ktoś odpisze.

Czy asystent obsługuje połączenia głosowe tak samo jak SMS-y?

Logi połączeń czytamy i analizujemy tak samo jak logi wiadomości, nagrania pobieramy przez Recording SID i transkrybujemy. Twilio i Vonage pozwalają też budować proste menu głosowe (IVR) bez sprzętu w biurze. Asystent analizuje nagrania i transkrypcje, ale nie prowadzi rozmowy głosowej na żywo z klientem.

Ile pracy wymaga utrzymanie bazy wiedzy asystenta na bieżąco?

Na start wystarczy kilkadziesiąt dobrze opisanych wpisów pokrywających najczęstsze pytania: godziny, cennik, procedury. Bazę aktualizuje osoba wyznaczona po stronie firmy, bez wiedzy technicznej. Błędne odpowiedzi asystenta trafiają jako sygnał, gdzie brakuje wpisu albo gdzie istniejący wymaga korekty.

Pełny opis integracji w bazie wiedzy →

Jak zaczynamy

  1. Bezpłatna prezentacja. Mówicie, na czym pracujecie i co Was korkuje. Mówimy wprost, czy da się to spiąć, a jeśli nie ma czego automatyzować, też to powiemy.
  2. Do 2 tygodni testów. Dostęp do portalu tego samego dnia, podłączenie w trybie odczytu, sprawdzacie na własnych danych.
  3. Rozszerzanie. Kolejne moduły i akcje dokładamy, gdy zespół ufa temu, co dostaje. W abonamencie jest wdrożenie, integracja, szkolenie i opieka.
Wybierzcie termin → Wolicie napisać?
Wolicie napisać

Pokażemy to na Waszych danych z Twilio i Vonage

Jedno zdanie wystarczy: czego szukacie w Twilio i Vonage albo co ma się dziać samo. Odpiszemy, co podłączymy i od czego zacząć.

Twilio i Vonage jest znakiem towarowym swojego właściciela. Nie jesteśmy z nim powiązani ani przez niego autoryzowani. Nazwy używamy wyłącznie po to, żeby wskazać, z jakim programem integrujemy asystenta.