Controle e agende suas campanhas de SMS com uma API flexível

Otimize suas ações de marketing e informe seus clientes sobre promoções no momento certo, usando as funções de agendamento e validade da campanha. Vá além, use o reagendamento e atualização de status das mensagens para tornar sua empresa ainda mais responsiva às demandas dos clientes. O agendamento, juntamente a outras ações, pode ser configurado através do Portal da Infobip ou da nossa API de SMS.

Você pode usar vários canais para manter os clientes bem informados e satisfeitos, mas se o seu canal preferido é o SMS, é fundamental desenvolver uma boa campanha de marketing e fazer com que as mensagens sejam enviadas no horário mais apropriado aos clientes.

REAGENDAMENTO DE MENSAGENS EM MASSA COM A API DE SMS

Se você já usa a API de SMS da Infobip para enviar campanhas aos clientes, essas dicas permitirão que você tenha ainda mais controle no envio das mensagens. Você poderá revisar o agendamento de envio, checar o status da mensagem e configurar o período de validade da campanha.

Para mudar o horário de envio da mensagem, é possível usar a função de reagendamento. Reagendar (e cancelar) mensagens em massa é possível quando uma solicitação avançada de SMS contém apenas uma mensagem por “lote” e a mensagem “massificada” é única. Se você não marcar que é “massificada” na solicitação inicial de envio do SMS, o sistema criará um único ID e irá incluí-lo como “massificado” na resposta. O ID pode ser usado depois, quando precisar obter informações de envio. Também é importante notar que múltiplas mensagens em uma solicitação de envio de massa não podem ser atualizadas, pois cada mensagem pode conter uma data e horário diferentes de envio e ter um status diferente.

Para começar a reagendar mensagens, é preciso inserir uma solicitação JSON com "bulkId":

PUT /sms/1/bulks?bulkId=a6e6bf50-ade1-4dd5-8900-d5b3bb18c0cc HTTP/1.1
Host: api.infobip.com
Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==
Content-Type: application/json
{
    "sendAt": "2021-08-25T16:00:00.000+0000"
}

A resposta para essa solicitação seria:

{
  "bulkId": "a6e6bf50-ade1-4dd5-8900-d5b3bb18c0cc",
  "sendAt": "2021-08-26T16:00:00.000+0000"
}

2015-07-07T17:00:00.000+01:00 é o formato da data e hora para o agendamento e reagendamento do SMS.

ATUALIZANDO O STATUS DA MENSAGEM

Atualizar o status da mensagem pode ser útil às vezes, pois pode ser usado para pausar, reiniciar e/ou cancelar mensagens agendadas.

O status “PENDENTE” pode ser atualizado para: “PAUSADO” e “CANCELADO”. Já o “PAUSADO” pode ser atualizado para “PENDENTE” ou “CANCELADO”.

Os status “PENDENTE” e “PAUSADO” podem ser mudados quantas vezes quiser, antes que a mensagem comece a ser processada ou, para sermos ainda mais precisos, quando o tempo agendado acabar e a mensagem for enviada. Mas, se o status da mensagem for mudado para “CANCELADA”, ela não poderá ser reagendada ou atualizada com um novo status, e permanecerá sem ser enviada.

O status pode ser atualizado facilmente. Se desejar atualizar o status da mensagem para “PAUSADO”, pode fazer isso com uma simples solicitação JSON:

PUT /sms/1/bulks/status?bulkId=a6e6bf50-ade1-4dd5-8900-d5b3bb18c0cc HTTP/1.1
Host: api.infobip.com
Authorization: Basic b25lYXBpOnRoZUJveA==
Content-Type: application/json

{
    "status": "PAUSED"
}

Com a resposta JSON:

{
  "bulkId": "a6e6bf50-ade1-4dd5-8900-d5b3bb18c0cc",
  "status": "PAUSED"
}

CONFIGURANDO O PERÍODO DE VALIDADE

Exceto em casos de reagendamento e atualização do status da mensagem, o período de validade pode ser bem útil. Pode ser configurado enquanto uma mensagem de texto com recursos é enviada, por um período máximo de 48 horas. Se inserir um período mais longo, ficará automaticamente configurado por 48 horas.

Para configurar o período de validade, é necessário postar uma solicitação JSON::

POST /sms/1/text/advanced HTTP/1.1
Host: api.infobip.com
Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==
Content-Type: application/json

{
   "messages":[
      {
         "from":"InfoSMS",
         "destinations":[
            {
               "to":"41793026727",
            },
            {
               "to":"41793026731"
            }
         ],
         "text":"The time-traveling is just too dangerous. Better that I devote myself to study the other great mystery of the universe: women!",
         "validityPeriod": 1440
      }
   ]
}

Com a resposta

HTTP/1.1 200 OK
Content-Type: application/json

{
  "bulkId": "a6e6bf50-ade1-4dd5-8900-d5b3bb18c0cc",
  "messages": [
    {
      "to": "41793026727",
      "status": {
        "groupId": 1,
        "groupName": "PENDING",
        "id": 7,
        "name": "PENDING_ENROUTE",
        "description": "Message sent to next instance"
      },
      "smsCount": 1,
      "messageId": "239a1bed-91d0-4454-a437-6663938465aa"
    },
    {
      "to": "41793026731",
      "status": {
        "groupId": 1,
        "groupName": "PENDING",
        "id": 7,
        "name": "PENDING_ENROUTE",
        "description": "Message sent to next instance"
      },
      "smsCount": 1,
      "messageId": "77a6e601-c12d-4a66-8e16-d8ec8c5fbc03"
    }
  ]
}

Tenha em mente que o período de validade é registrado em minutos. Após a configuração do período, não será permitido o envio da mensagem quando este expirar.

Essas são só algumas dicas para deixar seu negócio funcionando e manter seus clientes felizes. Para mais informações sobre integrações e diferentes canais de comunicação, visite a nossa central de desenvolvedores. .