Ersten Anruf tätigen

Tätigen Sie einen echten Telefonanruf aus dem Dashboard. Das Dashboard-Telefon ist ein SIP-Client, der dieselben Trunk-, Anrufer-ID- und Zieleinstellungen wie Ihr Telefonsystem 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 die Berechtigungen voice:write und voice_management:read 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 offen, 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 benennt jede fehlende Voraussetzung 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 Nummer, die Ihnen gehört, 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 hören Sie 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 Zeile From des Telefons hinzu.

4. Zielland aktivieren

Öffnen Sie Voice > Destinations. Suchen Sie das Land, das Sie anrufen möchten, und aktivieren Sie den zugehörigen 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 Zeile To 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 Sie bidirektionales Audio haben. Um den Anruf vom Dashboard aus zu beenden, wählen Sie Hang up.

6. Anrufdatensatz prüfen

Öffnen Sie Voice > Legs. 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 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 list

curl -X GET "https://{region}.platform.bird.com/v1/voice/legs" \
  -H "Authorization: Bearer $TOKEN" \
  --url-query "limit=25"

Verwenden Sie den Anrufdatensatz, um künftige Anruffehler zu untersuchen. Ein abgelehnter Anruf speichert seine Ursache in rejection_reason. Für Dashboard-Filter, Datensatzfelder und API-Zugriff siehe den Leitfaden zum Anrufprotokoll.

Testanruf beheben

• Das Telefon zeigt weiterhin Finish setup to place calls an: Erfüllen Sie jede nicht abgehakte Voraussetzung über den Link in der jeweiligen Checklistenzeile.
• 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 Zeile From 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: Prüfen Sie die Mikrofonberechtigung Ihres Browsers und die Mikrofonauswahl im Telefon. Der Leitfaden zu Gesprächssteuerungen 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.