Ersten Anruf tätigen
Tätigen Sie einen echten Telefonanruf über das Dashboard. Das Dashboard-Telefon ist ein SIP-Client, der denselben Trunk, dieselbe Anrufer-ID und dieselben Zieleinstellungen wie Ihre Telefonanlage verwendet.
Nach dem Anruf können Sie den Datensatz im Dashboard oder über die Voice-API einsehen.
Voraussetzungen
Stellen Sie vor dem Start sicher, dass Sie Folgendes haben:
- Einen Workspace mit Phone unter Voice. Das Dashboard zeigt es an, wenn Ihre Workspace-Region Browseranrufe unterstützt und Sie Voice-Zugriff auf der Ebene Write haben.
- Eine Telefonnummer, die Ihnen gehört, und ein Telefon, das die Verifizierungs- und Testanrufe entgegennehmen kann.
- Einen Browser mit einem funktionierenden Mikrofon.
1. Telefon öffnen
Wählen Sie Voice > Phone im Dashboard. Das Telefon öffnet sich in einem schwebenden Fenster und bleibt geöffnet, während Sie navigieren.
Wenn Ihr Workspace noch nicht bereit ist, Anrufe zu tätigen, zeigt das Telefon Finish setup to place calls an. Die Checkliste identifiziert jede fehlende Anforderung und verlinkt zur erforderlichen Aktion. Das Erstellen eines anrufbereiten Trunks und das Verifizieren einer Anrufer-ID schließt die Checkliste ab.
2. Anrufbereiten Trunk erstellen
Wählen Sie Create a trunk aus der Checkliste. Geben Sie einen Namen ein und wählen Sie dann Create trunk.
Das Dashboard aktiviert ausgehende Anrufe und Session-Anmeldedaten, wenn es den Trunk erstellt. Der Trunk bietet auch den MD5-Digest, den der Browser verwendet. Die Checkliste markiert alle Trunk-Anforderungen als abgeschlossen.
3. Anrufer-ID verifizieren
Wählen Sie Verify a number you own aus der Checkliste. Geben Sie eine Ihnen gehörende Nummer im Feld Phone number im E.164-Format ein: ein führendes +, die Landesvorwahl und die nationale Nummer. Wählen Sie dann Send verification call.
Nehmen Sie den Verifizierungsanruf entgegen und merken Sie sich den sechsstelligen Code. Geben Sie ihn im Feld Verification code ein und wählen Sie dann Verify caller ID.
Das Dashboard zeigt Caller ID verified an, entfernt den Einrichtungshinweis und fügt die Nummer zur From-Zeile des Telefons hinzu.
4. Zielland aktivieren
Öffnen Sie Voice > Destinations. Suchen Sie das Land, das Sie anrufen möchten, und aktivieren Sie den Schalter.
Anrufe in deaktivierte Länder werden abgelehnt, bevor die Plattform einen Carrier anwählt.
5. Anruf tätigen
Geben Sie die verifizierte Nummer in der To-Zeile ein und wählen Sie dann Call. Falls Ihr Browser Mikrofonzugriff anfordert, erlauben Sie ihn.
Ihr Telefon klingelt und zeigt die verifizierte Anrufer-ID an. Nehmen Sie den Anruf entgegen und bestätigen Sie, dass bidirektionales Audio funktioniert. Um den Anruf vom Dashboard aus zu beenden, wählen Sie Hang up.
6. Anrufdatensatz prüfen
Öffnen Sie Voice > Calls. Die Seite listet Anrufe nach Startzeit auf, neueste zuerst, sodass Ihr Anruf in der ersten Zeile erscheint. Wählen Sie ihn aus, um zu prüfen, wann er beantwortet wurde, seine abrechenbare Dauer und seine Kosten nach Abschluss der Tarifierung.
Dieselben Anrufdatensätze sind über die API verfügbar:
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"Verwenden Sie den Anrufdatensatz, um künftige Anruffehlschläge zu untersuchen. Ein abgelehnter Anruf speichert seine Ursache in rejection_reason. Für Dashboard-Filter, Datensatzfelder und API-Zugriff siehe den Anrufprotokoll-Leitfaden.
Testanruf untersuchen
- Das Telefon zeigt weiterhin Finish setup to place calls an: Schließen Sie jede nicht abgehakte Anforderung über den Link in der entsprechenden Checklistenzeile ab.
- Das Telefon zeigt einen Ablehnungsgrund an: destination_not_enabled bedeutet, dass das Zielland deaktiviert ist. caller_id_not_verified bedeutet, dass die Nummer in der From-Zeile nicht verifiziert ist. Die Referenz für abgelehnte Anrufe behandelt jeden Grund und seine Lösung.
- Der Anruf wird verbunden, aber eine Seite hat kein Audio: Überprüfen Sie die Mikrofonberechtigung Ihres Browsers und die Mikrofonauswahl im Telefon. Der Leitfaden für Gesprächssteuerung behandelt die Geräteauswahl.
Voice-Fehlerbehebung behandelt dieselben Symptome für jeden Client.
Nächste Schritte
- Testanrufe vom Terminal: Tätigen Sie denselben Anruf mit bird voice tools test-call.
- SIP-Client einrichten: Verbinden Sie Asterisk, FreePBX, Zoiper oder einen anderen Client mit dem Trunk.
- SIP-Trunks konfigurieren: Prüfen Sie die vom anrufbereiten Trunk aktivierten Einstellungen und andere Zulassungsmethoden.
- Anrufe tätigen: Erfahren Sie, wie die Plattform Anrufe routet und bepreist.
- Anrufprotokoll einsehen: Datensätze filtern, Felder prüfen, Anrufe über die API abrufen oder CSV-Daten exportieren.
- Voice-Events abonnieren: Senden Sie Anrufergebnisse an Ihre Systeme, statt abzufragen.
Verwandte Ressourcen
Weiter mit der Dokumentation, Anleitungen und Beispielen zu diesem Thema. Die Ressourcen sind auf Englisch.
Das Konzept verstehenWhat is a voice API?Die Funktion erkundenVoiceImplementierungsleitfadenVoice overview
Implementierungs-Briefing erhalten