Rejestr połączeń
Rejestr połączeń w sekcji Voice > Calls zawiera listę każdego połączenia wykonanego przez Twój obszar roboczy i każdego połączenia, które dotarło na jeden z jego numerów, od najnowszego. Każdy wpis to rekord szczegółów połączenia (CDR), obejmujący połączenia zestawione, nieodebrane i odrzucone. Użyj go, aby sprawdzić czas trwania, końcową odpowiedź SIP i koszt.
Bird zapisuje każdy rekord po zakończeniu połączenia, więc każde połączenie w rejestrze ma ostateczny wynik. Zakładka Live obok niego zawiera połączenia wciąż trwające.
Lista połączeń
Każdy wiersz to jedno połączenie:
| Kolumna | Co pokazuje |
|---|---|
| Status | Jak zakończyło się połączenie (zobacz Statusy) |
| From | Numer dzwoniącego, identyfikator prezentowany przez Twoje urządzenie |
| To | Numer, na który wykonano połączenie |
| Direction | Outbound dla połączeń wykonanych przez Twoje urządzenie, inbound dla połączeń przychodzących na Twoje numery |
| Duration | Całkowity czas trwania połączenia, od momentu odebrania go przez Bird do rozłączenia |
| Started | Kiedy Bird odebrał połączenie |
Lista jest podzielona na strony, po 25 połączeń na stronę. Wybierz dowolny wiersz, aby otworzyć połączenie.
Połączenia na żywo
Zakładka Live wyświetla aktualnie trwające połączenia i zawiera licznik, dzięki któremu widzisz ile ich jest bez otwierania zakładki. Połączenie na żywo ma jeden z dwóch statusów:
| Status | Co się dzieje |
|---|---|
| Ringing | Połączenie dotarło do celu, który jeszcze nie odebrał |
| In progress | Cel odebrał i połączenie jest zestawione |
Kolumny odpowiadają rejestrowi połączeń z wyjątkiem Elapsed, która zastępuje Duration. Dla zestawionego połączenia liczy czas od odebrania, a dla dzwoniącego od rozpoczęcia. Zakładka odświeża się co kilka sekund. Gdy połączenie się kończy, przenosi się do rejestru z ostatecznym wynikiem.
Wyszukiwanie i filtrowanie
Na górze strony znajduje się wyszukiwarka numerów i filtry. Można je łączyć: filtr statusu plus zakres dat zawęża wyniki do połączeń spełniających oba kryteria.
Wyszukiwanie po numerze. Pole wyszukiwania dopasowuje numer do obu stron połączenia, więc jedno zapytanie znajduje zarówno połączenia na ten numer, jak i z niego.
Kierunek. Filtruj do połączeń 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 zakładce 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:
| Kafelek | Co zlicza |
|---|---|
| Calls | Zakończone rekordy połączeń w danym miesiącu, łącznie z nieodebranymi i odrzuconymi |
| Total duration | Suma czasu trwania wszystkich połączeń, od momentu odebrania przez Bird do rozłączenia |
| Billable time | Suma czasu rozmów (od odebrania do rozłączenia) wszystkich połączeń |
Różnica między całkowitym czasem trwania a czasem naliczanym to czas dzwonienia bez odpowiedzi. Nieodebrane połączenie nie ma czasu naliczanego.
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
Połączenie w rejestrze zakończyło się jednym z następujących wyników:
| Status | Co się stało |
|---|---|
| Answered | Cel odebrał. Czas naliczany liczy się od odebrania do rozłączenia |
| No answer | Połączenie dzwoniło u celu i nie zostało odebrane przed upływem limitu czasu |
| Rejected | Połączenie zostało odrzucone zamiast zestawione |
| Failed | Podjęto próbę połączenia, ale się nie powiodła; SIP response to odpowiedź, która wróciła |
| Unknown | Nie udało się ustalić wyniku, na przykład gdy nie dotarła żadna końcowa odpowiedź |
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 połączenia pokazuje, co Bird o nim zapisał:
| Pole | Co zawiera |
|---|---|
| Status | Wynik połączenia (zobacz Statusy). Połączenie odrzucone przez Bird pokazuje też powód i co zrobić |
| SIP response | Końcowy kod SIP połączenia, na przykład 200 lub 486. Połączenie odrzucone przez Bird nosi 503, bez udziału operatora |
| From / To | Oba numery, każdy z możliwością skopiowania |
| Inbound route | Przy połączeniu przychodzącym: co numer docelowy miał robić (dostarczyć na trunk, przekierować lub odrzucić). Zawiera link do tego numeru |
| Trunk | Trunk SIP, na którym połączenie przyszło lub na który zostało dostarczone; przydatne, gdy kilka lokalizacji współdzieli obszar roboczy |
| Started | Kiedy Bird odebrał połączenie |
| Answered | Kiedy połączenie zostało odebrane, lub Not answered |
| Ended | Kiedy połączenie zostało rozłączone |
| Call ID | Własny identyfikator rekordu (vcl_…). Podaj go w zgłoszeniu do supportu i użyj do korelacji z własnymi logami |
| Session ID | Wspólny dla wszystkich odcinków jednego połączenia (vcs_…), dzięki czemu powiązane rekordy można grupować. Przekierowane połączenie ma dwa odcinki z jednym identyfikatorem |
| Billing | Czas naliczany, całkowity czas trwania i koszt połączenia po wycenie |
Inbound route pojawia się tylko przy połączeniach przychodzących i podaje, co numer miał robić, a nie czy się udało: trunk route przy odrzuconym połączeniu oznacza numer skierowany na trunk, który połączenia nie przyjął. Odbieranie połączeń opisuje trzy możliwe ustawienia i co każde 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ć
| Powód | Co się stało | Co zrobić |
|---|---|---|
| source_not_allowed | Połączenie przyszło z adresu, którego nie obejmuje lista dozwolonych IP trunka | Dodaj adres, z którego wysyła Twój system telefoniczny, do trunka |
| caller_id_not_verified | Numer w nagłówku From nie jest zweryfikowanym identyfikatorem dzwoniącego w tym obszarze roboczym | Zweryfikuj ten numer lub użyj numeru już zweryfikowanego |
| destination_not_enabled | Połączenia do tego kraju są wyłączone dla Twojego obszaru roboczego | Włącz ten kraj w sekcji Destinations |
| insufficient_balance | Twój portfel nie pokrywał kosztu połączenia, więc Bird odmówił z góry | Doładuj portfel lub włącz automatyczne doładowania, aby niskie saldo nie przerywało połączeń |
| daily_spend_exceeded | Połączenie przekroczyłoby dzienny limit wydatków na głos Twojej organizacji | Poczekaj na reset limitu na początku następnego dnia UTC lub poproś Bird o jego podniesienie |
| concurrent_calls_exceeded | Masz tyle jednoczesnych połączeń, ile pozwala Twoje konto | Poczekaj na zakończenie połączenia lub skontaktuj się z supportem, aby podnieść limit |
| calls_per_second_exceeded | Inicjujesz nowe połączenia szybciej, niż pozwala Twoje konto | Zmniejsz tempo wybierania, a potem spróbuj ponownie. Natychmiastowe ponawianie da ten sam wynik |
| number_ownership_not_verified | Kupiłeś ten numer, ale kraj, który go wydał, nie zaakceptował jeszcze dokumentów potwierdzających własność | Uzupełnij to, czego wymaga pole ownership numeru, a następnie ponów połączenie |
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 leżą po stronie Bird. Skontaktuj się z supportem i podaj Call ID z rekordu:
| Powód | Co się stało |
|---|---|
| routing_not_configured | Routing Twojego obszaru roboczego jest jeszcze podłączany, co jest normalne, gdy trwa konfiguracja nowej usługi głosowej |
| no_route_found | Routing jest podłączony, ale nie obejmuje wybranego numeru. Skontaktuj się z supportem, podając call ID, aby sprawdzić trasę |
| destination_blocked | Konfiguracja routingu Bird blokuje połączenia do tego celu |
| call_not_permitted | Bird nie mógł zrealizować połączenia dla Twojego konta, więc odmówił, zamiast zestawiać je na nieznanych warunkach |
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 zakładce Call log eksportuje wszystkie rekordy pasujące do bieżących filtrów ze wszystkich stron. Użyj go do uzgodnień i raportowania ad hoc.
- Odczyt przez API. GET /v1/voice/calls zwraca przefiltrowaną listę, a GET /v1/voice/calls/{call_id} zwraca jeden rekord. Oba wymagają klucza API z zakresem voice na poziomie read. Ustawienia trunka, identyfikatora dzwoniącego i celu nie są częścią publicznego API.
- Odczyt z terminala. Bird CLI udostępnia bird voice list, bird voice 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
| Strona | Co opisuje |
|---|---|
| Zdarzenia głosowe | Trzy zdarzenia połączeń, ich payloady i jak je konsumować |
| Wykonywanie połączeń | Czego Bird oczekuje na INVITE i jak wyceniane jest połączenie |
| Odbieranie połączeń | Kierowanie numeru na trunk lub przekierowanie i co jest rejestrowane |
| Trunki SIP | Lista dozwolonych IP, dozwolone klucze API i ustawienia Digest |
| Destynacje głosowe | Włączanie krajów i co oznacza dostępność |
| Błędy | Odpowiedź z błędem API i jej pola naprawcze |
Powiązane zasoby
Kontynuuj z dokumentacją, przewodnikami i przykładami dotyczącymi tego tematu. Zasoby są w języku angielskim.