Sign inGet Started

Zarządzanie numerami WhatsApp

Otwórz Numbers, aby zobaczyć swoje numery WhatsApp, ich status połączenia i powiązane konta firmowe. Aby dodać numer, przejdź do Podłącz swój numer.
Strona Numbers WhatsApp w Bird, pokazująca statusy numerów i ich konta firmowe

Sprawdź status połączenia

StatusCo zrobić
PreparingPoczekaj, aż Bird zweryfikuje numer należący do Twojego obszaru roboczego.
Pre-verifiedWybierz Finish setting up, aby połączyć numer przez Meta.
PendingPoczekaj, aż Bird zarejestruje numer w Meta.
ConnectedTwój numer jest gotowy do wysyłki.
FailedOtwórz numer, aby sprawdzić przyczynę błędu.
W przypadku verification_code_not_received lub verification_rate_limited wybierz Try again na stronie numeru. Zobacz błędy wstępnej weryfikacji, aby poznać czas ponownej próby. W przypadku innych błędów konfiguracji odłącz numer, zanim podłączysz go ponownie.

Przegląd podłączonego numeru

Otwórz numer, aby zobaczyć jego Quality rating, Messaging limit i Send rate. Te wartości pochodzą z Meta. Not rated oznacza, że Meta nie ma jeszcze wystarczającej historii, aby ocenić numer.
Podłączony numer WhatsApp w Bird z oceną jakości, limitem wiadomości, szybkością wysyłki i kartą Business profile
Użyj Business profile, aby zaktualizować nazwę wyświetlaną, opis, adres i zdjęcie profilowe widoczne dla odbiorców. Sekcja Activity pokazuje aktywność wysyłkową.

Przegląd konta firmowego

Wybierz konto w kolumnie WABA, aby przejrzeć WhatsApp Business Account będące właścicielem numeru.
WhatsApp Business Account w Bird ze statusem weryfikacji, weryfikacją firmy i szczegółami konta
  • Business verification wpływa na dostęp do funkcji, takich jak własne szablony uwierzytelniania.
  • Marketing Messages API pokazuje, czy Meta zaakceptowała konto do swoich optymalizacji dostarczania wiadomości marketingowych. Wiadomości marketingowe można wysyłać przed onboardingiem, ale nagłówki GIF wymagają jego ukończenia.
  • Last read from WhatsApp pokazuje, kiedy Bird ostatnio odświeżył te dane.
Obszar roboczy może mieć kilka kont firmowych. Sprawdź konto powiązane z numerem, z którego zamierzasz wysyłać.

Odczytaj swoje numery z API

Użyj klucza API z dostępem do odczytu whatsapp_management. Wyświetl numery zwraca stronicowaną listę numerów:
for await (const number of bird.whatsapp.numbers.list({ limit: 25 })) {
  console.log(number.id, number.phone_number, number.status);
}
Odczytaj numer, aby uzyskać jego status, ocenę jakości i limity wysyłki. Powiązane odczyty:
EndpointZwraca
Profil numeruOpis, adres i strony internetowe.
Zdarzenia numeruZmiany konfiguracji, statusu, jakości, limitu i nazwy wyświetlanej, od najnowszych.
Konta firmoweWhatsApp Business Accounts obszaru roboczego.
Szczegóły konta firmowegoWeryfikacja konta, weryfikacja firmy, onboarding marketingowy i status kondycji Meta.
meta_synced_at zawiera datę ostatniego odczytu wartości z Meta. Nie występuje przy numerach domyślnych. meta_health_status nie występuje, dopóki Bird nie odczyta konta. Pole waba numeru zawiera identyfikator konta Meta.
Podczas konfiguracji status może mieć wartość preparing lub awaiting_signup. Pole next opisuje następną akcję, a finish_setup_url otwiera krok w przeglądarce. Zdarzenie type jest otwartym typem wyliczeniowym, więc obsługuj nieznane wartości bez błędów.
Użyj panelu lub CLI, aby podłączyć, zmienić nazwę lub odłączyć numer; te akcje nie są częścią publicznego API ani SDK. Komendy CLI to bird whatsapp numbers create|update|delete i bird whatsapp numbers profile update. Tworzenie połączenia zwraca finish_setup_url, ponieważ krok zgody Meta wymaga przeglądarki.

Odbieranie wiadomości

Wiadomości przychodzące na podłączone numery pojawiają się w dzienniku WhatsApp. Metryki Inbound pokazują liczbę odebranych wiadomości według numeru. Każda wiadomość przychodząca otwiera 24-godzinne okno obsługi klienta umożliwiające swobodne odpowiedzi.

Opcje numerów

Jeśli numer należy do Twojego obszaru roboczego w Bird, Podłącz swój numer pokazuje automatyczną weryfikację i konfigurację Meta. Jeśli numer jest u innego dostawcy, wybierz I have my own number i samodzielnie odbierz kod SMS lub kod głosowy od Meta. W przypadku istniejącej rejestracji użyj obsługiwanej migracji lub kwalifikującej się ścieżki współistnienia aplikacji Business. Wpisz Phone registration PIN tylko wtedy, gdy numer już ma taki kod na WhatsApp.
Numery domyślne wysyłają obsługiwane szablony bez konieczności podłączania własnego numeru.

Następne kroki