Skip to main content

Como enviar mensagem por meio da lista de broadcast com um template de mensagem via API do Blip


Izabella_Castro
Blipper

Olá, pessoal!

Para realizar disparos de mensagens para uma lista do broadcast utilizando um modelo via API, será necessário juntar duas querys em uma só.

Primeiramente, pegaremos a query para disparo de mensagem por meio da lista de broadcast. Para isso, basta acessar o link Send message broadcast list.

Na documentação, teremos a seguinte estrutura para o envio de mensagem:

POST https://{{contract.id}}.http.msging.net/messages HTTP/1.1
Content-Type: application/json
Authorization: Key {YOUR_TOKEN}

{  
  "id": "{{RANDOM_ID}}",
  "to": "[email protected]",
  "type": "text/plain",
  "content": "Hello participants of this list!"
}

Agora, pegaremos a query para realizar o disparo de mensagem por meio do modelo criado no Blip. Para isso, seguiremos a documentação do help center Como enviar notificações WhatsApp via API do Blip.

Na documentação, é possível enviar mensagens com imagens, vídeos, texto, entre outros. Para este exemplo, utilizaremos a query para envio de mensagem de texto:

POST https://{{contract.id}}.http.msging.net/messages HTTP/1.1
Content-Type: application/json
Authorization: Key YOUR_TOKEN

{
   "id":"{{RANDOM_ID}}",
   "to":"[email protected]",
   "type":"application/json",
   "content":{
      "type":"template",
      "template":{
         "name":"{{MESSAGE_TEMPLATE_NAME}}",
         "language":{
            "code":"pt_BR",
            "policy":"deterministic"
         },
         "components":[
            {
                "type": "body",
                "parameters": [
                    {
                        "type": "text",
                        "text": "parâmetro1"
                    },
                    {
                       "type":"text",
                       "text":"parâmetro2"
                    }
                ]
            }
          ]
        }
    }
}

Para criar a query, basta juntar a estrutura do disparo para a lista de broadcast com a estrutura do envio de mensagem via modelo cadastrado. Dessa forma, a query ficará da seguinte maneira:

POST https://{{contract.id}}.http.msging.net/messages HTTP/1.1
Content-Type: application/json
Authorization: Key YOUR_TOKEN

{  
  "id": "{{RANDOM_ID}}",
  "to": "[email protected]",
  "type": "application/json",
   "content":{
      "type":"template",
      "template":{
         "name":"{{MESSAGE_TEMPLATE_NAME}}",
         "language":{
            "code":"pt_BR",
            "policy":"deterministic"
         },
         "components":[
            {
                "type": "body",
                "parameters": [
                    {
                        "type": "text",
                        "text": "parâmetro1"
                    },
                    {
                       "type":"text",
                       "text":"parâmetro2"
                    }
                ]
            }
          ]
        }
    }
}

Com essa estrutura, é possível realizar disparos de modelo de mensagem por meio de uma lista de broadcast utilizando a API.

OBS: Para realizar essa requisição via Postman é só mudar o id de {{RANDOM_ID}} para {{$guid}}

Para mais informações sobre como criar a lista de broadcast e modelos de mensagem, acesse os links abaixo:
Como criar lista de contatos no RCS
Como criar e aprovar um Message Template no WhatsApp

Espero que eu tenha ajudado!!
Até a próxima! 😀