Enviar un mensaje MMS a un grupo

En este fragmento de código verás cómo enviar un mensaje MMS colectivo mediante la Messages API.

IMPORTANTE: Actualmente, solo se admiten US Short Codes, números 10DLC y números gratuitos con función SMS para el envío de MMS. En el caso de los US Short Codes, se pueden enviar mensajes MMS a las redes de AT&T, T-Mobile (antes Sprint) y Verizon en EE. UU. Más información sobre la configuración de números 10DLC (nota: esta página hace referencia a la SMS API, pero el contenido de la sección de directrices 10 DLC también se aplica a la Messages API).

El rendimiento de los mensajes, la capacidad de entrega y los volúmenes de mensajes SMS pueden variar en función del tipo de número utilizado. Para obtener más información al respecto, así como sobre los MMS en general, consulta la Página de información general sobre MMS de VonageEl Página de información general de Vonage 10DLC, y el Página de resumen de Vonage Phone Numbers.

Ejemplo

A continuación encontrará la descripción de todas las variables utilizadas en cada fragmento de código:

ClaveDescripción
MESSAGES_API_URL

There are two versions of the API, each with their own endpoints. For production the previous Messages API endpoint was https://api.nexmo.com/v0.1/messages, the new one is https://api.nexmo.com/v1/messages. For sandbox testing the Messages API endpoint is https://messages-sandbox.nexmo.com/v0.1/messages or https://messages-sandbox.nexmo.com/v1/messages, depending on which version you have set in the sandbox dashboard.

MESSAGES_TO_NUMBER

The number you are sending the to in E.164 format. For example 447700900000.

MMS_SENDER_ID

The alphanumeric string that represents the name or number of the organization sending the message.

SECOND_MESSAGES_TO_NUMBER

The phone number of the second recipient.

NOTA: No utilice un + o 00 Al introducir un número de teléfono, empieza por el código de país; por ejemplo, 14155550105.

Requisitos previos

Si no tiene una solicitud, puede crear uno. Asegúrese también de configure sus webhooks.

Escriba el código

Añada lo siguiente a send-mms-group-message.sh:

curl -X POST "${MESSAGES_API_URL}" \
  -H "Authorization: Bearer "$JWT\
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -d $'{
    "to": "'${MESSAGES_TO_NUMBER}'",
    "from": "'${MMS_SENDER_ID}'",
    "channel": "mms",
    "message_type": "text",
    "text": "This is an MMS group message sent via the Vonage Messages API.",
    "mms": {
      "participants": [
        '${SECOND_MESSAGES_TO_NUMBER}'
      ]
    }
  }'

curl -X POST "${MESSAGES_API_URL}" \
  -H "Authorization: Bearer "$JWT\
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -d $'{
    "to": "'${SECOND_MESSAGES_TO_NUMBER}'",
    "from": "'${MMS_SENDER_ID}'",
    "channel": "mms",
    "message_type": "text",
    "text": "This is an MMS group message sent via the Vonage Messages API.",
    "mms": {
      "participants": [
        '${MESSAGES_TO_NUMBER}'
      ]
    }
  }'

Ver fuente completa

Ejecute su código

Guarde este archivo en su máquina y ejecútelo:

bash send-mms-group-message.sh

Pruébalo

Al ejecutar el código, se envía un mensaje MMS colectivo a los dos participantes del grupo.