Wykonaj pierwsze połączenie
Wykonaj prawdziwe połączenie telefoniczne z dashboardu. Telefon w dashboardzie to klient SIP, który korzysta z tego samego trunku, identyfikatora dzwoniącego i ustawień docelowych co Twój system telefoniczny.
Po zakończeniu połączenia możesz sprawdzić jego rekord w dashboardzie lub przez Voice API.
Wymagania wstępne
Zanim zaczniesz, upewnij się, że masz:
- Obszar roboczy z opcją Phone w sekcji Voice. Dashboard wyświetla ją, gdy region Twojego obszaru roboczego obsługuje połączenia z przeglądarki i masz dostęp do Voice na poziomie Write.
- Numer telefonu, który posiadasz, oraz telefon zdolny odebrać połączenia weryfikacyjne i testowe.
- Przeglądarkę z działającym mikrofonem.
1. Otwórz telefon
Wybierz Voice > Phone w dashboardzie. Telefon otwiera się w pływającym oknie i pozostaje otwarty podczas nawigacji.
Jeśli Twój obszar roboczy nie jest gotowy do wykonywania połączeń, telefon wyświetla Finish setup to place calls. Lista kontrolna wskazuje każdy brakujący wymóg i prowadzi do wymaganej akcji. Utworzenie trunku gotowego do połączeń i zweryfikowanie identyfikatora dzwoniącego kończy listę kontrolną.
2. Utwórz trunk gotowy do połączeń
Wybierz Create a trunk z listy kontrolnej. Wprowadź nazwę, a następnie wybierz Create trunk.
Dashboard włącza połączenia wychodzące i poświadczenia sesji podczas tworzenia trunku. Trunk udostępnia również skrót MD5 używany przez przeglądarkę. Lista kontrolna oznacza wszystkie wymagania trunku jako spełnione.
3. Zweryfikuj identyfikator dzwoniącego
Wybierz Verify a number you own z listy kontrolnej. Wprowadź posiadany numer w polu Phone number w formacie E.164: wiodący +, kod kraju i numer krajowy. Następnie wybierz Send verification call.
Odbierz połączenie weryfikacyjne i posłuchaj sześciocyfrowego kodu. Wprowadź go w polu Verification code, a następnie wybierz Verify caller ID.
Dashboard wyświetla Caller ID verified, usuwa komunikat o konfiguracji i dodaje numer do wiersza From w telefonie.
4. Włącz kraj docelowy
Otwórz Voice > Destinations. Znajdź kraj, do którego zamierzasz dzwonić, i włącz jego przełącznik.
Połączenia do wyłączonych krajów są odrzucane, zanim platforma wybierze numer u operatora.
5. Wykonaj połączenie
Wprowadź zweryfikowany numer w wierszu To, a następnie wybierz Call. Jeśli przeglądarka poprosi o dostęp do mikrofonu, zezwól na to.
Twój telefon dzwoni i wyświetla zweryfikowany identyfikator dzwoniącego. Odbierz połączenie i potwierdź, że masz dwukierunkowe audio. Aby zakończyć połączenie z dashboardu, wybierz Hang up.
6. Sprawdź rekord połączenia
Otwórz Voice > Calls. Strona wyświetla połączenia według czasu rozpoczęcia, od najnowszych, więc Twoje połączenie pojawia się w pierwszym wierszu. Wybierz je, aby sprawdzić, kiedy zostało odebrane, jego czas rozliczeniowy i koszt po zakończeniu taryfikacji.
Te same rekordy połączeń są dostępne przez API:
for await (const call of bird.voice.list({ status: ["ringing", "in_progress"] })) {
console.log(call.id, call.status);
}for call in client.voice.list(status=["ringing", "in_progress"]):
print(call.id, call.status)for call, err := range client.Voice.List(context.Background(), bird.VoiceListParams{
Status: []bird.VoiceCallStatus{"ringing", "in_progress"},
}) {
if err != nil {
log.Fatal(err)
}
fmt.Println(call.Id, call.Status)
}foreach ($bird->voice->list(['status' => ['ringing', 'in_progress']]) as $call) {
echo $call->getId(), ' ', $call->getStatus(), "\n";
}bird voice list{
"name": "voice_list"
}curl -X GET "https://{region}.platform.bird.com/v1/voice/calls" \
-H "Authorization: Bearer $TOKEN" \
--url-query "limit=25"Użyj rekordu połączenia do badania przyszłych problemów z połączeniami. Odrzucone połączenie przechowuje przyczynę w rejection_reason. Informacje o filtrach dashboardu, polach rekordów i dostępie przez API znajdziesz w przewodniku po logach połączeń.
Rozwiązywanie problemów z połączeniem testowym
- Telefon nadal wyświetla Finish setup to place calls: Spełnij każdy nieodznaczony wymóg, korzystając z linku w odpowiednim wierszu listy kontrolnej.
- Telefon wyświetla powód odrzucenia: destination_not_enabled oznacza, że kraj docelowy jest wyłączony. caller_id_not_verified oznacza, że numer w wierszu From nie jest zweryfikowany. Dokumentacja odrzuconych połączeń opisuje każdy powód i sposób jego rozwiązania.
- Połączenie jest nawiązane, ale jedna strona nie ma dźwięku: Sprawdź uprawnienia mikrofonu w przeglądarce i wybór mikrofonu w telefonie. Przewodnik po kontrolkach podczas połączenia opisuje selektory urządzeń.
Rozwiązywanie problemów z Voice prowadzi przez te same objawy dla dowolnego klienta.
Następne kroki
- Połączenia testowe z terminala: wykonaj to samo połączenie za pomocą bird voice tools test-call.
- Skonfiguruj klienta SIP: podłącz Asterisk, FreePBX, Zoiper lub innego klienta do trunku.
- Skonfiguruj trunki SIP: przejrzyj ustawienia włączane przez trunk gotowy do połączeń i inne metody uwierzytelniania.
- Wykonuj połączenia: dowiedz się, jak platforma kieruje i wycenia połączenia.
- Przeglądaj log połączeń: filtruj rekordy, przeglądaj pola, pobieraj połączenia przez API lub eksportuj dane CSV.
- Subskrybuj zdarzenia głosowe: wysyłaj wyniki połączeń do swoich systemów zamiast odpytywać API.
Powiązane zasoby
Kontynuuj z dokumentacją, przewodnikami i przykładami dotyczącymi tego tematu. Zasoby są w języku angielskim.