Disparador de Twilio Voice

Dispara un flujo de trabajo cuando se reciben llamadas telefónicas a través de Twilio Voice

Dispara un flujo de trabajo cuando se reciben llamadas telefónicas a través de Twilio Voice

Este es un disparador basado en webhook. Configura el servicio externo para enviar eventos a la URL del webhook del flujo de trabajo.

Instrucciones de configuración

  1. Introduce una respuesta TwiML arriba: indica a Twilio qué hacer cuando entra una llamada (p. ej., reproducir un mensaje, grabar, recopilar entrada). Nota: usa corchetes [Tag] en lugar de corchetes angulares para las etiquetas TwiML

  2. Ejemplo de TwiML para grabar con transcripción: [Response][Say]Please leave a message.[/Say][Record transcribe="true" maxLength="120"/][/Response]

  3. Ve a la página Phone Numbers de Twilio Console en https://console.twilio.com/us1/develop/phone-numbers/manage/incoming

  4. Selecciona el número de teléfono que quieres usar para las llamadas entrantes.

  5. Desplázate hasta la sección "Voice Configuration".

  6. En el campo "A CALL COMES IN", selecciona "Webhook" y pega la URL del webhook (de arriba).

  7. Asegúrate de que el método HTTP esté configurado en POST.

  8. Haz clic en "Save configuration".

  9. Cómo funciona: cuando entra una llamada, Twilio recibe tu respuesta TwiML de inmediato y ejecuta esas instrucciones. Tu flujo de trabajo se ejecuta en segundo plano con acceso a la información del llamante, el estado de la llamada y cualquier dato grabado o transcrito.

Configuración

SID de cuenta de Twilio*
ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Tu SID de cuenta de Twilio de la consola de Twilio
Token de autenticación*
••••••••
Tu token de autenticación de Twilio para verificar la firma del webhook
Respuesta TwiML
[Response][Say]Por favor, espere.[/Say][/Response]
Instrucciones TwiML que se devuelven de inmediato a Twilio. Usa corchetes en lugar de ángulos (p. ej., [Response] en lugar de <Response>). Esto controla lo que ocurre cuando entra la llamada (p. ej., reproducir un mensaje, grabar, recopilar entrada). Tu workflow se ejecutará en segundo plano.

Esquema de salida

Payload del evento
callSidstringIdentificador único de esta llamada
accountSidstringSID de cuenta de Twilio
fromstringNúmero de teléfono del llamante (formato E.164)
tostringNúmero de teléfono del destinatario (tu número de Twilio)
callStatusstringEstado de la llamada (queued, ringing, in-progress, completed, etc.)
directionstringDirección de la llamada: inbound o outbound
apiVersionstringVersión de la API de Twilio
callerNamestringNombre del identificador de llamadas si está disponible
forwardedFromstringNúmero de teléfono que desvió esta llamada
digitsstringDígitos DTMF introducidos por el llamante (de <Gather>)
speechResultstringResultado del reconocimiento de voz (si se usa <Gather> con voz)
recordingUrlstringURL de la grabación de la llamada si está disponible
recordingSidstringSID de la grabación si está disponible
calledstringNúmero de teléfono al que se llamó (igual que "to")
callerstringNúmero de teléfono del llamante (igual que "from")
toCitystringCiudad del número llamado
toStatestringEstado/provincia del número llamado
toZipstringCódigo postal del número llamado
toCountrystringPaís del número llamado
fromCitystringCiudad del llamante
fromStatestringEstado/provincia del llamante
fromZipstringCódigo postal del llamante
fromCountrystringPaís del llamante
calledCitystringCiudad del número llamado (igual que toCity)
calledStatestringEstado del número llamado (igual que toState)
calledZipstringCódigo postal del número llamado (igual que toZip)
calledCountrystringPaís del número llamado (igual que toCountry)
callerCitystringCiudad del llamante (igual que fromCity)
callerStatestringEstado del llamante (igual que fromState)
callerZipstringCódigo postal del llamante (igual que fromZip)
callerCountrystringPaís del llamante (igual que fromCountry)
callTokenstringToken de llamada de Twilio para autenticación
rawstringPayload completo y sin procesar del webhook de Twilio como cadena JSON