You are viewing the Spanish (Mexico) site, but your language preference is set to English. Switch to English site →

Menu

Expand
Calificar esta página:

Nuestra solicitud a tu URL de webhook

Cuando llega un mensaje entrante a tu número de teléfono de Twilio, Twilio envía una solicitud a tu aplicación web mediante una solicitud de webhook. Esta solicitud contiene información acerca del mensaje entrante, como su remitente y cualquier medio adjunto. La aplicación puede almacenar estos datos o utilizarlos para personalizar una respuesta, por ejemplo.

Twilio hace solicitudes de HTTP a tu aplicación, al igual que un navegador web normal, en el formato application/x-www-form-urlencoded. Cuando se incluyen parámetros y valores en sus peticiones, Twilio envía datos a tu aplicación sobre los que puedes actuar antes de responder.

Puedes configurar las URL y los métodos HTTP que Twilio utiliza para realizar sus peticiones a través del portal de tu cuenta en la Consola de Twilio o utilizando la API REST.

Ten en cuenta que Twilio no puede almacenar POST en caché. Si deseas que Twilio almacene en caché las páginas TwiML estáticas, configura Twilio para que haga peticiones a tu aplicación usando GET.

Parámetros en la solicitud de Twilio a tu aplicación

Cuando Twilio recibe un mensaje en uno de tus números de Twilio o un número habilitado para WhatsApp, hace una petición HTTP sincrónica a la URL del mensaje configurada para ese número o al servicio de mensajería y espera recibir TwiML como respuesta.

Twilio envía los siguientes parámetros con su solicitud como parámetros POST o de consulta URL, dependiendo del método HTTP que hayas configurado:

Parámetros de solicitud

PARÁMETRO DESCRIPCIÓN EJEMPLO
MessageSid Identificador único de 34 caracteres para el mensaje. Se puede utilizar para recuperar más adelante este mensaje de la API REST. SMXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
SmsSid Mismo valor que MessageSid. Obsoleto e incluido por compatibilidad con versiones anteriores. SMXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
AccountSid ID de 34 caracteres de la cuenta a la que está asociado este mensaje. ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
MessagingServiceSid (SID del servicio de mensajería) ID de 34 caracteres del servicio de mensajería asociado al mensaje. MGXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
De El número de teléfono o la dirección del canal que envió este mensaje. +14017122661
To (Para) El número de teléfono o la dirección del canal del destinatario. +15558675310
Body (Texto) El cuerpo del texto del mensaje. Hasta 1600 caracteres de longitud. ¡"Ahoy! We can't wait to see what your build."
NumMedia Número de elementos de medios asociados con el mensaje 0
ReferralNumMedia Número de elementos de medios asociados a un anuncio de "Click to WhatsApp". 0

Parámetros relacionados con el medio

Twilio también envía los siguientes parámetros cuando hay medios, como imágenes, asociados al mensaje entrante:

PARÁMETRO DESCRIPCIÓN EJEMPLO
MediaContentType{N} Los ContentTypes para los medios almacenados en MediaUrl{N}. El orden de MediaContentType{N} coincide con el orden de MediaUrl{N}. Si NumMedia indica más de un elemento de medios, se utilizará MediaContentType{N}, en el que N es el índice basado en cero del medio (por ejemplo, MediaContentType0) imagen o jpeg
MediaUrl{N} Una URL que hace referencia al contenido de los medios recibidos en el mensaje. Si NumMedia indica más de un elemento de medios, se utilizará MediaUrl{N}, donde N es el índice basado en cero del medio (por ejemplo, MediaUrl0)

https://api.twilio.com/2010-04-01/Accounts/ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/Messages/MMXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/Media/MEXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

Parámetros relacionados con los datos geográficos

Twilio también intenta buscar datos geográficos basados en los números de teléfono “From” (Origen) y “To” (Destino). Twilio envía los siguientes parámetros, si están disponibles:

PARÁMETRO DESCRIPCIÓN EJEMPLO
FromCity La ciudad del remitente SAN FRANCISCO
FromState Estado o provincia del remitente. CA
FromZip El código postal del remitente llamado. 94103
FromCountry País del remitente llamado. EE. UU.
ToCity Ciudad del destinatario. SAUSALITO
ToState Estado o provincia del destinatario. CA
ToZip Código postal del destinatario. 94965
ToCountry País del destinatario. EE. UU.

Parámetros específicos de WhatsApp

Para mensajes de WhatsApp, Twilio envía los siguientes parámetros adicionales:

PARÁMETRO DESCRIPCIÓN EJEMPLO
ProfileName Nombre del perfil de WhatsApp del remitente Perspective Coffee
WaId El ID de WhatsApp del remitente (por lo general, un número de teléfono) 14017122661
Se reenvía true si el mensaje se ha reenviado una vez verdadero
FrequentlyForwarded true si el mensaje se ha reenviado con frecuencia verdadero
ButtonText Texto de un botón de respuesta rápida Cancelar cita

Para los mensajes de WhatsApp entrantes que comparten una ubicación, Twilio incluye los siguientes parámetros:

PARÁMETRO DESCRIPCIÓN EJEMPLO
Latitud Valor de la latitud de la ubicación que se envía 51.51322977399644
Longitud Valor de la longitud de la ubicación que se envía -0.2197976373036567
Dirección

Dirección de la ubicación que se envía

187 Freston Road, London, Greater London W10 6TH
Etiqueta

Etiqueta o nombre de la ubicación que se envía
The Harrow Club

Para los mensajes de WhatsApp entrantes que se originan en un anuncio de "Click-to-WhatsApp", Twilio incluye los siguientes parámetros:

PARÁMETRO DESCRIPCIÓN EJEMPLO
ReferralBody Cuerpo del texto del anuncio Para obtener más información sobre nuestra empresa, envíanos un mensaje en WhatsApp
ReferralHeadline Texto del encabezado del anuncio Envíanos un mensaje
ReferralSourceId ID de Meta o WhatsApp del anuncio 118588094077142
ReferralSourceType Tipo de anuncio publicación
ReferralSourceUrl Una URL que hace referencia al contenido de los medios que se muestran en el anuncio cuando el usuario hace clic para enviar un mensaje https://fb.me/xyz123
ReferralMediaId El ID de Meta o WhatsApp del medio publicitario que se muestra cuando los usuarios hacen clic para enviar un mensaje; no coincidirá con el SID de Twili Media e420b130-f934-4acf-a5e6-f964f776bxyz
ReferralMediaContentType ContentType de medios del medio de anuncio que se muestra al usuario cuando este hace clic para enviar un mensaje imagen o jpeg
ReferralMediaUrl Una URL que hace referencia a los medios que se muestran al usuario en el anuncio https://api.twilio.com/2010-04-01/Accounts/ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/Messages/MMXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/Media/MEXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

Parámetros de devolución de llamada de estado

Para las devoluciones de llamada de estado, Twilio también envía parámetros relacionados con el estado:

PARÁMETRO DESCRIPCIÓN EJEMPLO
MessageStatus El estado del mensaje. Puede ser: accepted, queued, sending, sent, failed, delivered, undelivered, receiving, received, or read (solo en WhatsApp). Para obtener más información, consulta las descripciones detalladas. entregado
SmsStatus Igual que el valor MessageStatus. Obsoleto e incluido por compatibilidad con versiones anteriores. entregado

Devolución de llamada de ErrorCode en mensajes de WhatsApp incorrectos

Si falla la entrega del mensaje con WhatsApp, los parámetros SmsStatus y MessageStatus leerán undelivered y Twilio devolverá el Error 63016 como ErrorCode=63016 en la respuesta del webhook.

Calificar esta página:

¿Necesitas ayuda?

Todos la necesitamos a veces; la programación es difícil. Obtén ayuda ahora de nuestro equipo de soporte, o recurre a la sabiduría de la multitud visitando Stack Overflow Collective de Twilio o navegando por la etiqueta de Twilio en Stack Overflow.

        
        
        

        Gracias por tus comentarios.

        Selecciona los motivos de tus comentarios. La información adicional que nos brindas nos ayuda a mejorar nuestra documentación:

        Enviando tus comentarios…
        🎉 Gracias por tus comentarios.
        Se produjo un error. Inténtalo de nuevo.

        Gracias por tus comentarios.

        thanks-feedback-gif