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

Quer que as suas campanhas sejam mais envolventes? Use múltiplas opções para agendamento do envio de mensagens.

June 02 2017

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

CONTROLE AS SUAS MENSAGENS

SAIBA MAIS