Enviar uma mensagem em grupo por MMS

Neste trecho de código, você verá como enviar uma mensagem MMS em grupo usando a Messages API.

IMPORTANTE: Atualmente, apenas US Short Codes, números 10DLC e números gratuitos habilitados para SMS são compatíveis com o envio de MMS. No caso dos US Short Codes, as mensagens MMS podem ser enviadas para as redes da AT&T, T-Mobile (anteriormente Sprint) e Verizon nos EUA. Saiba mais sobre como configurar números 10DLC (observação: esta página faz referência à SMS API, mas o conteúdo da seção “10 diretrizes para DLC” também se aplica à Messages API).

A taxa de processamento de mensagens, a taxa de entrega e os volumes de mensagens SMS podem variar dependendo do tipo de número utilizado. Para obter mais informações sobre isso e sobre MMS em geral, consulte o Página de visão geral do MMS da Vonage, o Página de visão geral do 10DLC da Vonage, e o Página de visão geral dos números de telefone da Vonage.

Exemplo

Veja a seguir a descrição de todas as variáveis utilizadas em cada trecho de código:

Chave	Descrição
`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: Não use um espaço à esquerda + ou 00 Ao digitar um número de telefone, comece com o código do país, por exemplo, 14155550105.

Pré-requisitos

Se você não tiver um aplicativo, acesse criar um. Certifique-se também de acessar configure seus webhooks.

Escreva o código

Adicione o seguinte ao arquivo ` 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 código-fonte completo

Execute seu código

Salve este arquivo no seu computador e execute-o:

bash send-mms-group-message.sh

Experimente

Ao executar o código, uma mensagem MMS em grupo é enviada aos dois participantes do grupo.