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ń destynacji 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órego jesteś właścicielem, oraz telefon, który może 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 zawiera link 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 dane uwierzytelniające 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ź numer, którego jesteś właścicielem, w polu Phone number w formacie E.164: początkowy +, 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 powiadomienie o konfiguracji i dodaje numer do wiersza From w telefonie.
4. Włącz kraj docelowy
Otwórz Voice > Destinations. Znajdź kraj, do którego planujesz dzwonić, i włącz jego przełącznik.
Połączenia do wyłączonych krajów są odrzucane, zanim platforma wybierze 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 > Legs. 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 rozliczany czas trwania i koszt po zakończeniu taryfikacji.
Te same rekordy połączeń są dostępne przez API:
for await (const leg of bird.voice.legs.list()) {
console.log(leg.id, leg.status);
}for leg in client.voice.legs.list():
print(leg.id, leg.status)for leg, err := range client.Voice.Legs.List(context.Background(), bird.VoiceLegsListParams{}) {
if err != nil {
log.Fatal(err)
}
fmt.Println(leg.Id, leg.Status)
}foreach ($bird->voice->legs->list() as $leg) {
echo $leg->getId(), ' ', $leg->getStatus(), "\n";
}bird voice legs listcurl -X GET "https://{region}.platform.bird.com/v1/voice/legs" \
-H "Authorization: Bearer $TOKEN" \
--url-query "limit=25"Użyj rekordu połączenia do badania przyszłych niepowodzeń połączeń. 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 niespełniony 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 zostaje nawiązane, ale jedna strona nie ma audio: Sprawdź uprawnienia mikrofonu w przeglądarce i wybór mikrofonu w telefonie. Przewodnik po sterowaniu podczas połączenia opisuje wybór urządzeń.
Rozwiązywanie problemów z Voice opisuje 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.
- Konfiguracja trunków SIP: przejrzyj ustawienia włączane przez trunk gotowy do połączeń i inne metody uwierzytelniania.
- Wykonywanie połączeń: dowiedz się, jak platforma trasuje i taryfikuje połączenia.
- Przeglądanie logów połączeń: filtruj rekordy, przeglądaj pola, pobieraj połączenia przez API lub eksportuj dane CSV.
- Subskrypcja zdarzeń głosowych: 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.