Enviar um MMS com failover

Neste exemplo, você enviará um MMS que pode, em caso de falha, ser substituído pelo envio de um SMS.

No objeto Workflow, os objetos de mensagem podem ser organizados em qualquer ordem, de acordo com o seu caso de uso. Cada objeto de mensagem deve conter um objeto de failover, exceto a última mensagem, já que não há mais objetos de mensagem para os quais se possa realizar o failover.

NOTA: O MMS é compatível apenas com US Short Codes.

Exemplo

Certifique-se de que as seguintes variáveis estejam definidas com os valores desejados, utilizando qualquer método conveniente:

ChaveDescrição
VONAGE_APPLICATION_ID

The Vonage Application ID.

FROM_NUMBER

The phone number you are sending the MMS from. (US Short Code, 10DLC number, or SMS Enabled Toll Free Number)

TO_NUMBER

Replace with the number you are sending to. E.g. 447700900001

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, 447700900000.

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-with-failover.sh`:

curl -X POST https://api.nexmo.com/v0.1/dispatch \
  -H 'Authorization: Bearer '$JWT\
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -d $'{
    "template":"failover",
    "workflow": [
      {
        "from": { "type": "mms", "number": '$FROM_NUMBER' },
        "to": { "type": "mms", "number": '$TO_NUMBER' },
        "message": {
          "content": {
            "type": "img",
            "image": { "url": "$IMG_URL" }
          }
        },
        "failover":{
          "expiry_time": 600,
          "condition_status": "delivered"
        }
      },
      {
        "from": {"type": "sms", "number": '$FROM_NUMBER'},
        "to": { "type": "sms", "number": '$TO_NUMBER'},
        "message": {
          "content": {
            "type": "text",
            "text": "This is an SMS sent via the Dispatch API"
          }
        }
      }
    ]
  }'

Ver código-fonte completo

Execute seu código

Salve este arquivo no seu computador e execute-o:

bash send-mms-with-failover.sh

Experimente

Ao executar o código, ele tentará enviar um MMS. Se isso não der certo, por exemplo, porque o destinatário é da T-Mobile, será enviada uma mensagem por SMS para o número de destino.