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 sich den sechsstelligen Code an. 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

Wählen Sie unten im Telefon den Status aus und wählen Sie Online. Wenn Sie in einem Browser zum ersten Mal online gehen, öffnet das Telefon Settings: Wählen Sie Ihr Microphone und Ihren Speaker aus und wählen Sie dann Go online. Ein Telefon im Status Offline kann keine Anrufe 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, die neuesten zuerst, sodass Ihr Anruf in der ersten Zeile erscheint. Wählen Sie ihn aus, um zu prüfen, wann er angenommen wurde, wie lange seine abrechenbare Dauer ist und was er nach Abschluss der Tarifierung kostet.

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 Einstellungen, die der anrufbereite Trunk aktiviert, sowie 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.