Dokumentacja narzędzi MCP
Konektor udostępnia ponad 30 narzędzi dla każdego połączenia na koncie. list_numbers jest pierwsze dla WhatsApp, którego narzędzia wymagają jego connection_id, a list_social_accounts dla pozostałych kanałów, których narzędzia wymagają account_id. Sześć narzędzi jest blokowanych po wygaśnięciu płatności: cztery narzędzia WhatsApp działające w świecie zewnętrznym, get_api_credentials, które zwraca token dostępu, oraz create_connect_link. Pozostałe pozostają dostępne.
Narzędzia udostępniane przez konektor.
Narzędzia blokowane po wygaśnięciu płatności, w tym get_api_credentials, które zwraca token dostępu.
Logowanie OAuth obejmuje każdy numer na koncie.
Co robi każde narzędzie?
Odczyt: list_numbers zwraca połączone numery wraz ze statusem, oceną jakości i poziomem wiadomości. Od tego wywołania zaczyna się każda inna operacja. get_number_health zwraca aktualny obraz z Meta oraz razem oś czasu monitorowania, zdarzenia webhooka i kontrole pollera. get_api_credentials zwraca bazowy URL Graph API, WABA id, phone number id oraz, jeśli jest dostępny, własny token dostępu konta.
Wysyłanie: send_message wysyła dowolny tekst w ciągu 24-godzinnego okna, w którym odpowiedzi są bezpłatne. send_template wysyła zatwierdzony szablon i służy do rozpoczęcia rozmowy z osobą, która jeszcze nie napisała. list_templates, create_template i get_template_status obsługują cały cykl życia szablonu.
Połączenie: set_webhook_destination kieruje przychodzące wiadomości i echa aplikacji do Twojego systemu, a przekazanie null przywraca ustawienia domyślne. get_connect_link zwraca link do panelu oraz instrukcje połączenia nowego numeru. get_docs zwraca dokumentację produktu w formacie markdown.
Partner API, dla oprogramowania lub agencji, których klienci podłączają własne numery: get_partner_setup pokazuje stan płatności, klucza API, adresu URL zdarzeń oraz następny krok. create_api_key wydaje klucz Partner API i pokazuje go tylko raz, a istniejącego klucza nie zastąpi bez wyraźnego potwierdzenia. revoke_api_key unieważnia klucz, również po potwierdzeniu. set_partner_events_url ustawia, dokąd trafiają zdarzenia statusu, i jednorazowo zwraca sekret podpisu. create_connect_link tworzy hostowany link połączenia dla jednego klienta, ważny 1 godzinę, tak samo jak POST /api/v1/connect-sessions.
Dlaczego connection_id ma znaczenie?
Ponieważ łączy instrukcję z konkretnym numerem, a asystent nie może go odgadnąć.
Każde narzędzie działające na numerze wymaga connection_id, a jedynym źródłem tej wartości jest list_numbers. W praktyce oznacza to, że asystent poproszony o wysłanie wiadomości najpierw wywoła list_numbers. Dlatego pierwsze żądanie w sesji często trwa dłużej niż kolejne.
Dzięki temu konto z kilkoma numerami jest jednoznaczne z założenia. Nie ma numeru domyślnego ani niejawnego wyboru, więc instrukcja, która nie wskazuje, o który numer chodzi, wymaga doprecyzowania, a nie zgadywania.
Co dzieje się po wygaśnięciu płatności?
Blokowanych jest sześć narzędzi: send_message, send_template, create_template i set_webhook_destination, które działają w świecie zewnętrznym; get_api_credentials, ponieważ zwraca token dostępu konta, za pomocą którego zablokowane konto mogłoby wysyłać wiadomości bezpośrednio przez Graph API; oraz create_connect_link, które podłącza nowy numer. Każdy inny odczyt pozostaje dostępny, podobnie jak konfiguracja Partner API: get_partner_setup, create_api_key, revoke_api_key i set_partner_events_url.
To celowe działanie, a nie przeoczenie. Konto, które nie może sprawdzić przyczyny blokady ani stanu swoich numerów, nie ma innej drogi powrotu poza zgłoszeniem do pomocy technicznej. Te same odczyty są też podstawą monitorowania kondycji, więc ich blokada wyłączyłaby monitorowanie dokładnie wtedy, gdy jest najbardziej potrzebne.
W praktyce konto z nieuregulowaną płatnością nadal odpowiada na pytania o swój stan i nadal jest monitorowane. Zatrzymane zostaje tylko to, co dociera do klienta.
Typowe błędy
- Oczekiwanie, że konektor będzie odbierać wiadomości. MCP działa na zasadzie żądania i odpowiedzi, a ruch przychodzący wymaga webhooka.
- Wpisywanie connection_id na stałe. Wartość pochodzi z list_numbers i nie należy jej zapisywać ręcznie.
- Założenie, że konto z nieuregulowaną płatnością jest całkowicie offline. Odczyty i monitorowanie celowo działają dalej, z wyjątkiem danych uwierzytelniających, które zawierają token do wysyłania.
Jeden konektor obsługuje każdy numer na koncie i jest autoryzowany przez OAuth, bez wklejania klucza. Od US$ 9 za numer miesięcznie, do US$ 0,75 wraz z dodawaniem kolejnych numerów, z pierwszymi 3 dniami bezpłatnie.
Najczęściej zadawane pytania
Czy wybieram narzędzie, które ma zostać wywołane?
Nie. Opisujesz potrzebę zwykłym językiem, a asystent wybiera narzędzie. Do tego służą opisy narzędzi.
Czy konektor może odczytywać moje rozmowy?
Nie. Przychodzące wiadomości trafiają do wskazanego przez Ciebie miejsca docelowego webhooka. Konektor odczytuje stan konta i numerów.
Czy get_docs jest przydatne?
Bardziej, niż się wydaje. Przekazuje asystentowi naszą dokumentację w formacie markdown, więc odpowiedzi o zasadach Coexistence pochodzą z naszych materiałów, a nie z pamięci.
Czy jeden konektor obsługuje kilku klientów?
Tak. Jedno konto może zawierać dowolną liczbę potrzebnych numerów, a list_numbers zwraca je wszystkie.
Czytaj dalej
Gotowy, aby zacząć?
Skonfiguruj WhatsApp Coexistence w kilka minut, nie miesięcy. Aplikacja nadal działa na telefonie.
Rozpocznij bezpłatny okres próbnyZweryfikowano w