Mensaje de TwiML™: <Mensaje>
El verbo <Message> envía un mensaje a un número de teléfono o un
SIM inalámbrico.
Atributos del verbo
El verbo <Message> soporta los siguientes atributos que modifican su comportamiento:
| Nombre de atributo | Valores permitidos | Valor predeterminado |
|---|---|---|
| to | número de teléfono, SID de SIM inalámbrica | consulta a continuación |
| from | número de teléfono, cadena de 1 a 11 caracteres (de A a Z, de a a z, de 0 a 9), SID de SIM inalámbrica | consulta a continuación |
| action | URL relativa o absoluta | ninguno |
| method | GET, POST | POST |
to
El atributo “to” toma un número de teléfono válido como argumento. Twilio enviará el mensaje al número proporcionado. Si no se proporciona el atributo “to”, Twilio enviará el mensaje como respuesta al remitente actual.
Los números de teléfono deben tener el formato “+” y el código del país; por ejemplo,
+16175551212 (formato E.164). Para números “to” (Destino) sin “+”,
Twilio usará el mismo código de país que el número “from” (Origen). Twilio
también intentará manejar números con formato local para ese código de país
(por ejemplo, (415) 555-1212 para EE. UU., 07400123456 para GB). Si estás enviando a
un país diferente al número “from” (Origen), debes incluir un “+”
y el código de país para asegurar la entrega correcta.
Si tienes una cuenta de prueba, el número de teléfono to (Destino) debe ser verificado con Twilio. Pero no es necesario especificar el atributo to para enviar un mensaje de respuesta al remitente actual.
Enviar a una SIM inalámbrica
Para obtener más información sobre el envío a una SIM inalámbrica, consulta "Mensajes al dispositivo" en la documentación de SMS inalámbrica programable.
from
El atributo “from” toma como argumento un número de teléfono válido o un ID de remitente alfanumérico. Si se utiliza un número de teléfono, debe ser un número que hayas comprado o que hayas portado a Twilio.
Los ID de remitente alfanuméricos solo se pueden utilizar cuando se envían mensajes a países en los que la función es soportada. Los ID de remitente alfanuméricos están limitados a 11 caracteres. Los caracteres aceptados incluyen letras ASCII en mayúsculas y minúsculas, los dígitos del 0 al 9 y el espacio: [de A a Z, de a a z, de 0 a 9]. El ID de remitente debe representar o estar asociado a la marca de tu empresa.
Cuando se envía un mensaje en respuesta a un mensaje entrante, “from” toma por defecto el
número de Twilio que recibió el mensaje. Si especificas un valor “from”, debe
ser un número de teléfono local con capacidad para mensajes asignado a tu cuenta. Si el número de teléfono
no es capaz de enviar mensajes, entonces “
action
El atributo “action” toma una URL como argumento. Al igual que el parámetro “StatusCallback” cuando se envía un mensaje saliente mediante la API REST, esta URL recibirá una solicitud HTTP con el estado de un mensaje enviado como respuesta a un mensaje entrante.
Los estados posibles para un mensaje son queued (en cola), failed (falla), sent (enviado), delivered (entregado) o undelivered (no entregado). Twilio enviará el MessageSid junto con los otros parámetros de solicitud estándar así como MessageStatus y ErrorCode. Las URL no relativas deben contener un nombre de host válido (no se permiten caracteres de subrayado).
El método HTTP utilizado para realizar la solicitud se configura en la propiedad method.
Parámetros de solicitud
Twilio pasará el parámetro MessageStatus además de los parámetros estándar de solicitud de mensaje TwiML con su solicitud a la URL “action”.
method
El atributo “method” toma el valor “GET” o “POST”. Esto le dice a Twilio si debe solicitar la URL de “action” mediante la HTTP GET o POST. Este atributo se modela a partir del atributo “method” del formulario HTML. “POST” es el valor predeterminado.
Parámetros de solicitud
Twilio pasará el parámetro MessageStatus además de los parámetros estándar de petición de mensaje TwiML con su petición a la URL “statusCallback”.
Parámetro MessageStatus
El parámetro MessageStatus se envía con peticiones a la URL de action o
a la URL de statusCallback. El parámetro contiene más información sobre el estado
del mensaje: si se ha enviado con éxito o si se ha producido un error
en la entrega (el número no era válido, no había cuerpo del mensaje, etc.)
| Parámetro | Descripción |
|---|---|
| MessageStatus | Estado actual del mensaje. Si está “queued” (en cola), “ending” (finalizando), “sent” (enviado), o “failed” (falla) |
Sustantivos
El "noun" de un verbo TwiML es la materia anidada dentro del verbo que no es un verbo en sí; es la materia sobre la que actúa el verbo. Estos son los sustantivos para <Message>:
| Sustantivo | Descripción |
|---|---|
| Texto sin formato | El texto del mensaje que deseas enviar. Debe tener menos de 1600 caracteres. |
| <Body> | El texto del mensaje que deseas enviar. Debe tener menos de 1600 caracteres. Si se utiliza más de un elemento <Body>; en un solo <Message>, el contenido de los dos se concatenará en un único valor Body. |
| <Media> | Un elemento XML anidado que indica la URL de una imagen que se va a enviar en el mensaje. Si deseas enviar más de una imagen, incluye más de un elemento <Media>. El número máximo de <Media> que se puede incluir en un mensaje determinado es 10. |
Consulta también
¿Deseas enviar un mensaje sin esperar un mensaje entrante? Consulta nuestradocumentación de mensajes salientes.
Ejemplos
Ejemplo 1: Envío simple de SMS
Este es el caso más simple para <Message>. Twilio envía un SMS con la ubicación de tu maravilloso establecimiento de retail.
Ejemplo 2: Envío de un mensaje con medios (MMS)
Para añadir una imagen al mensaje, puedes especificar una URL con el sustantivo de medios. También puedes encerrar el cuerpo en el sustantivo de cuerpo. Si especificas uno o más sustantivos de medios, el cuerpo es opcional.
Ejemplo 3: Informes de MessageStatus
En este caso de uso, hemos proporcionado la URL de “action” y los atributos de “method”. Ahora, cuando el mensaje esté en cola para su entrega , Twilio solicitará la URL de “action” pasando el parámetro “MessageStatus”. Si los mensajes están en cola y a la espera de ser enviados, “MessageStatus” tendrá el valor “sending”. Si se ha proporcionado un atributo no válido, “MessageStatus” será “invalid”.
Tu aplicación web puede ver el parámetro “MessageStatus” y decidir qué TwiML devolver.
Si se proporciona una URL de “action” para <Message>, el flujo de su aplicación continuará con el TwiML recibido en respuesta a la solicitud “action”.
Todos los verbos que queden en el documento serán inaccesibles y se ignorarán.
Reglas de anidamiento
No puedes anidar ningún verbo dentro de <Message> y no puedes anidar <Message> en ningún otro verbo. Los únicos elementos que pueden ser anidados dentro de un <Message> son los sustantivos <Body> y <Media>.
Anidar sustantivos dentro de un verbo <Message> como:
¿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.
