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 podlegający rozliczeniu 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.

Połączenie, które osiągnęło obowiązujący na platformie limit czasu trwania połączenia wynoszący 4 godziny, ma status Answered, ponieważ zostało zestawione, a następnie zakończone po osiągnięciu limitu. Czas podlegający rozliczeniu biegnie od odebrania do momentu, gdy Bird rozłączył połączenie. Jeśli połączenie było obsługiwane przez sekwencję, jego oś czasu pokazuje Time limit reached jako zakończenie odcinka.

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, a nie zestawione. Mogą to spowodować dwie różne sytuacje.

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.

Wybierany numer odrzucił połączenie. Połączenie przychodzące na numer ustawiony na odrzucanie lub na numer bez własnej trasy, gdy domyślna trasa obszaru roboczego to odrzucanie, jest odrzucane bez żadnego powodu: nie naruszono żadnego naszego warunku. Mówi o tym pole Inbound route. Odbieranie połączeń opisuje te odrzucenia.

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 odrzucił połączenie, a powód wskazuje, której kontroli połączenie nie przeszło. Pole SIP response zawiera kod 503, który otrzymał Twój system telefoniczny. Zastosuj wskazane dla tego powodu rozwiązanie dotyczące konta lub routingu. Przy połączeniu wychodzącym odpowiedź 503 zawiera nagłówek X-BIRD-CALL-ID z identyfikatorem Leg ID rekordu, dzięki czemu możesz powiązać odrzucenie z rekordem bez porównywania czasów i numerów.
• 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:

• Eksportuj CSV. Przycisk Download CSV na karcie Leg log eksportuje ze wszystkich stron rekordy pasujące do bieżących filtrów, do 10 000 odcinków. Większy wybór zwraca błąd bez pliku; zawęź zakres dat lub filtry i wyeksportuj każdy zestaw osobno. Plik zawiera czasy trwania i czas podlegający rozliczeniu, ale nie ma kolumny kosztu. Sprawdź opłaty w sekcji Zużycie, wydatki i faktury.
• Odczytuj je przez API. GET /v1/voice/legs i GET /v1/voice/legs/{leg_id} odczytują poszczególne odcinki (GET /v1/voice/calls i GET /v1/voice/calls/{call_id} obsługują odczyt zgrupowanych połączeń używany przez dashboard i CLI). Wszystkie wymagają klucza API z zakresem voice na poziomie read. Sprawdź w dokumentacji referencyjnej API opublikowane operacje dla pozostałych zasobów Voice i wymagane przez nie zakresy.
• Odczytuj je z terminala. Bird CLI udostępnia polecenia bird voice calls list, bird voice calls get, bird voice legs list, bird voice legs get i bird voice stats. Serwer MCP udostępnia agentom te same operacje odczytu.
• 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