Wat is een voice-API?

Een callback, telefoonmenu en spraakassistent gebruiken verschillende onderdelen van een belplatform.

Wat kan een voice-API besturen?

Een voice-API kan configuratie, gespreksbesturing en rapportage bieden, waarbij de ondersteunde bewerkingen door de provider worden bepaald.

Configuratie omvat trunks, beller-identiteiten, bestemmingen en nummerroutering. Gespreksbesturing omvat gedrag binnen een gesprek, zoals prompts of toetsinvoer. Rapportage geeft de status, duur en andere vastgelegde uitkomsten van het gesprek terug.

Providers drukken gespreksbesturing verschillend uit. Twilio's TwiML beschrijft bijvoorbeeld acties via instructies die aan Twilio worden teruggestuurd. Een applicatie verplaatsen betekent daarom het gedrag en de callback-verwachtingen in kaart brengen, niet alleen een hostnaam vervangen.

Een methode die een gesprek leest is geen bewerking die er een start.

Hoe werken een API en SIP samen?

Een applicatie-API kan een dienst configureren of besturen, terwijl SIP de telefoonsessie eronder tot stand brengt.

SIP, het signaliseringsprotocol voor gesprekken, maakt sessies aan, wijzigt ze en beëindigt ze. Het onderhandelt hoe deelnemers verbinding maken. RTP draagt real-time media zoals audio.

De paden kunnen onafhankelijk falen. Een gesprek kan overgaan terwijl een media-instelling of netwerkpad voorkomt dat een deelnemer de ander hoort. Test audio in beide richtingen, naast overgaan en ophangen.

Een PBX, het bedrijfstelefoonsysteem dat gesprekken routeert, kan zijn gespreksafhandeling behouden terwijl het de SIP-trunks van een provider gebruikt. Een conversationele runtime kan een vergelijkbare verbinding gebruiken en zelf spraak- en bedrijfstools leveren.

Wat kan ik over een gesprek lezen?

Een gespreksrecord identificeert de poging en rapporteert de waargenomen status. De beschikbare velden hangen af van de bewerking en de fase van het gesprek.

• Verbinding: of het gesprek werd toegelaten, overging en werd beantwoord.
• Media: of de deelnemers elkaar konden horen en met elkaar konden communiceren.
• Bedrijfsresultaat: of de beoogde afspraak, callback of supporttaak is voltooid.

Een beantwoord telefoongesprek kan bij een persoon, voicemail of een ander geautomatiseerd systeem terechtkomen. Het gespreksrecord alleen kan niet bewijzen dat een klant een taak heeft voltooid.

Events helpen je applicatie reageren op wijzigingen. Verwerk duplicaten en te laat bezorgde berichten en vergelijk ontbrekende of onzekere updates met de vastgelegde status van de provider.

Hoe bouw ik dit met Bird?

Je configureert uitgaand bellen met een SIP-trunk, een geverifieerde beller-ID en een ingeschakeld bestemmingsland.

Configuratiewijzigingen vereisen voice_management op schrijfniveau.

Op de trunk moet outbound_enabled de waarde true hebben. Het domain is het adres waarmee je SIP-client verbinding maakt. API-key-authenticatie vermeldt je sleutel in allowed_api_key_ids; de sleutel heeft voice op schrijfniveau nodig. Het bijwerken van die lijst vervangt alle vermeldingen, dus behoud sleutels die andere clients nog gebruiken.

Je beller-ID heeft status: verified nodig, wat bevestigt dat je werkruimte het verificatiegesprek heeft voltooid. Het phone_number bevat het internationale nummer, inclusief de voorloopwaarde +.

Het bestemmingsland heeft zowel enabled: true als status: available nodig. Het inschakelen van een land maakt een niet-ondersteunde bestemming niet bereikbaar.

De browsertelefoon vereist ook session_credentials_enabled: true op de trunk en MD5 in de lijst digest_algorithms van die trunk.

Na een gesprek bekijk je status, rejection_reason en sip_response_code. De bewerkingen voor het opvragen van een lijst met legs en het lezen van een leg geven deze velden terug. Deze bewerkingen rapporteren verbindingspogingen. Je SIP-applicatie start ze.

Voor een telefoonmenu configureer je prompts en vertakkingen op basis van toetsinvoer in de verbonden applicatie. Een voice-AI-runtime levert spraak, redenering en bedrijfstools voor een gesprek.