Dokumentacja narzędzi MCP

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.

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?

Blokowane są cztery narzędzia działające w świecie zewnętrznym: send_message, send_template, create_template i set_webhook_destination. Wszystko, co tylko odczytuje dane, pozostaje dostępne.

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.

Najczęściej zadawane pytania

Czytaj dalej