Rejestr połączeń

Dziennik odcinków w sekcji Voice > Legs zawiera listę wszystkich połączeń nawiązanych lub odebranych przez Twój obszar roboczy, od najnowszych. Jedno połączenie może składać się z kilku odcinków (legs), na przykład połączenia przychodzącego i przekierowanego. Każdy wpis to szczegółowy rekord połączenia (CDR), łącznie z połączeniami, które nie zostały odebrane lub zostały odrzucone. Użyj go, aby sprawdzić czas trwania, końcową odpowiedź SIP i koszt.

Bird zapisuje każdy rekord po zakończeniu odcinka, więc każdy wpis w dzienniku ma ostateczny wynik. Karta Live obok niego zawiera odcinki, które wciąż trwają.

Aby zobaczyć pełną interakcję, otwórz Voice > Calls. Połączenie grupuje powiązane odcinki i uczestników. Zachowaj Call ID do korelacji, a Leg ID do analizy pojedynczego połączenia. Identyfikują one różne rekordy.

Lista połączeń

Każdy wiersz to jeden odcinek. Połączenie z wieloma odcinkami ma wiele wierszy:

Lista jest podzielona na strony, 25 odcinków na stronę. Wybierz dowolny wiersz, aby otworzyć rekord odcinka.

Połączenia na żywo

Karta Live wyświetla odcinki aktualnie trwające i pokazuje ich liczbę, dzięki czemu widzisz, ile jest aktywnych, bez otwierania karty. Aktywny odcinek ma jeden z dwóch statusów:

Kolumny odpowiadają dziennikowi odcinków z wyjątkiem kolumny Elapsed, która zastępuje Duration. Liczy od momentu odebrania dla połączonego odcinka i od rozpoczęcia dla dzwoniącego odcinka. Karta odświeża się co kilka sekund. Gdy odcinek się kończy, przenosi się do dziennika odcinków z ostatecznym wynikiem.

Wyszukiwanie i filtrowanie

Na początku strony znajduje się wyszukiwanie po numerze i filtry. Można je łączyć: filtr statusu plus zakres dat zawęża wyniki do odcinków pasujących do obu warunków.

Wyszukiwanie po numerze. Pole wyszukiwania dopasowuje numer do dowolnej strony odcinka, więc jedno zapytanie znajduje odcinki do niego i odcinki od niego.

Kierunek. Filtruj do odcinków wychodzących lub przychodzących.

Status. Filtruj do jednego z: answered, no answer, failed, rejected lub unknown. Każdy jest zdefiniowany w sekcji Statusy. Na karcie Live dostępne opcje to ringing i in progress.

Data. W rejestrze połączeń wybierz preset (ostatnie 24 godziny, 7 dni lub 30 dni) albo ustaw własny zakres w kalendarzu.

Wykorzystanie w tym miesiącu

Podsumowanie miesięczne zawiera trzy kafelki dla bieżącego miesiąca kalendarzowego w UTC:

Różnica między całkowitym czasem trwania a czasem podlegającym rozliczeniu to czas dzwonienia bez odpowiedzi. Nieodebrany odcinek nie ma czasu podlegającego rozliczeniu.

Każda stawka docelowa zaokrągla czas naliczany do swojego interwału rozliczeniowego. Szczegóły cenowe znajdziesz w sekcji Koszty i rozliczenia.

Kafelki obejmują cały miesiąc niezależnie od tego, jak przefiltrujesz listę.

Statusy

Odcinek w dzienniku zakończył się jednym z poniższych wyników:

Rejected obejmuje dwa rodzaje odmów, a powód odrzucenia je rozróżnia. Albo Bird odrzucił połączenie, zanim zaangażowano operatora, i wówczas powód wskazuje nieudaną kontrolę, albo druga strona odmówiła bezpośrednio, i wówczas SIP response zawiera jej odpowiedź, a powód nie występuje. Połączenie przychodzące, które numer docelowy odrzucił, również ma status Rejected bez powodu, bo nie naruszyło żadnej kontroli: pole Inbound route podaje, co numer miał robić. Zobacz Odrzucone połączenia.

Failed to nie odmowa. Oznacza, że podjęto próbę połączenia, ale się nie powiodła: zajęty numer to Failed z odpowiedzią operatora 486, a nieprzydzielony numer to Failed z 404.

Jeśli odczytujesz te wartości z własnych narzędzi, obsługuj te, które rozpoznajesz, a każdą inną traktuj jako nieobsługiwany status, nie jako błąd. Lista zawiera również busy i canceled, zarezerwowane dla połączeń przychodzących dostarczanych na Twoje numery. Żaden z nich nie jest jeszcze emitowany i oba wyniki są raportowane jako failed.

Szczegóły połączenia

Otwarcie odcinka pokazuje, co Bird zarejestrował o tym połączeniu:

Inbound route pojawia się przy połączeniach przychodzących i podaje wybraną trasę. Trunk route przy odrzuconym połączeniu oznacza, że połączenie nie dotarło do działającego odbiorcy. Odbieranie połączeń opisuje trasy i co każda z nich rejestruje.

Odrzucone połączenia

Odrzucone połączenie zostało odmówione zamiast zestawione. Dwie różne rzeczy mogą to spowodować.

Bird odrzucił je, zanim zaangażowano operatora. Przed wybraniem numeru Bird sprawdza identyfikator dzwoniącego, cel, limity konta i saldo portfela, a następnie odmawia połączenia, które nie przejdzie jednej z tych kontroli. Twój system telefoniczny otrzymuje SIP 503, a uwierzytelniony rekord połączenia przechowuje konkretny powód. Zapobiega to ujawnieniu szczegółów konta nieuwierzytelnionym dzwoniącym. Otwórz połączenie, aby zobaczyć przyczynę i link do odpowiedniego ustawienia.

Wybrany numer odrzucił połączenie. Połączenie przychodzące na numer ustawiony na odrzucanie lub na numer, którego nikt nigdzie nie skierował, jest odrzucane bez żadnego powodu: nie naruszyło żadnej naszej kontroli. Informuje o tym pole Inbound route. Odbieranie połączeń opisuje te odmowy.

Poniższe powody dotyczą pierwszego rodzaju. Odnoszą się zarówno do połączeń przychodzących, jak i wychodzących, ponieważ limity konta i portfel są sprawdzane w obu przypadkach.

Powody, które możesz naprawić

Dialer kampanijny może trafić na calls_per_second_exceeded, nie zbliżając się do limitu jednoczesnych połączeń. Sprawdź więc, który z tych dwóch powodów otrzymałeś, zanim cokolwiek zmienisz.

Powody rozwiązywane przez Bird

Te przyczyny leżą po stronie Bird. Skontaktuj się ze wsparciem i podaj Leg ID z rekordu:

Jak wygląda odmowa

Odczytuj status i powód odrzucenia razem:

• Rejected z powodem odrzucenia. Bird odmówił połączenia, a powód wskazuje nieudaną kontrolę. SIP response to 503, który otrzymał Twój system telefoniczny. Zastosuj się do rozwiązania opisanego przy danym powodzie.
• Rejected bez powodu odrzucenia. Przy połączeniu wychodzącym druga strona odmówiła bezpośrednio, a SIP response zawiera jej kod. Przy połączeniu przychodzącym wybrany numer odrzucił połączenie, a Inbound route podaje, co ten numer miał robić.
• Failed. Podjęto próbę połączenia, ale się nie powiodła; SIP response zawiera kod, który wrócił. 486 oznacza zajętość, a 404 oznacza numer nieprzydzielony. Zazwyczaj wskazuje to na problem z numerem, nie z Twoją konfiguracją.

Połączenie, którego Bird w ogóle nie może wpuścić, jest odrzucane, zanim powstanie rekord, więc nigdy nie trafia do rejestru. Rozwiązywanie problemów z głosem opisuje takie przypadki.

Pobieranie rekordów

Cztery sposoby pracy z tymi rekordami poza dashboardem:

• Eksport CSV. Przycisk Download CSV na karcie Leg log eksportuje rekordy pasujące do bieżących filtrów ze wszystkich stron, do 10 000 odcinków. Większy zakres zwraca błąd bez pliku; zawęź zakres dat lub filtry i eksportuj każdą selekcję osobno. Użyj go do uzgodnień i raportowania ad hoc.
• Odczyt przez API. GET /v1/voice/legs zwraca przefiltrowaną listę, a GET /v1/voice/legs/{leg_id} zwraca pojedynczy rekord. Oba wymagają klucza API z zakresem voice na poziomie read. Sprawdź referencję API, aby poznać opublikowane operacje dla innych zasobów Voice i wymagane zakresy.
• Odczyt z terminala. Bird CLI udostępnia bird voice legs list, bird voice legs get i bird voice stats. Serwer MCP udostępnia te same odczyty agentom.
• Subskrypcja zdarzeń. voice_call.initiated, voice_call.answered i voice_call.ended są wysyłane na Twój endpoint w trakcie połączeń, więc Twoje systemy pozostają aktualne bez odpytywania. Zobacz Zdarzenia głosowe.

Następne kroki