Octadesk

Como faço o envio de mensagens via API no WhatsApp Oficial?

L

Escrito por Leon

atualizado

Escolha a seção


Quer enviar mensagens no seu WhatsApp Oficial via API? Vem com a gente que vamos te ajudar nisso. o/

Vamos explicar como fazer isso e personalizar mais ainda sua operação.

Como enviar mensagem de WhatsApp via API

Requisitos:

  1. Ter um número de WhatsApp Oficial ativo no ambiente;

  2. Ter modelos de mensagem aprovadas no ambiente;

  3. Ter o número do destinatário e ele possuir conta no WhatsApp (cliente que vai receber a mensagem).

Como fazer:

1 - Gerar apiKey:

Para gerar sua apiKey, basta seguir o procedimento deste material.

(Caso não esteja disponível em seu Octadesk, entre em contato conosco para possamos te orientar).

2 - Conhecendo a API Octadesk para envio de mensagens:

Essa é a URL da API que faz o envio de mensagens via WhatsApp Oficial: https://developers.octadesk.com/reference/sendtemplatemessage 

Lembrando que CustomFields são campos personalizados, e não campos padrões do Octadesk.

Ao lado direito teremos a área onde se preenche o Header:

É nele que colocamos o código gerado pelo ID do Tenant + “.” + Secret, exemplo:

fa2990aa-5168-4e51-a689-cf4192fd65aa.b0af9f53-4d57-41fa-b8e3-1a416d1265d1

Um pouco mais para baixo temos a Base URL, local onde colocamos a seguinte informação:

SUBDOMAIN.apiprd.octadesk.services (atenção: esta URL é um exemplo).

Exemplo: lojaoctadesk.apiprd.octadesk.services

E por fim, configuramos o Body da requisição:

Target: Destinatário (cliente);

Content: Template Message que será utilizado;

Origin: Remetente (número ativo no ambiente);

Exemplo de Target:

Exemplo de Content:

Onde achar o ID no Octadesk:


Exemplo de Origin:

Depois disso é só clicar no Try it e pronto. Veja um exemplo de corpo padrão:

{
    "target": {
        "contact": {
            "phoneContact": {
                "number": "+55NumeroDoContato"
            },
            "name": "NomeDesejado",
            "customFields": [{ "type": "person", "key": "codigo_do_campo", "value": "valor"}]
        }
    },
    "content": {
        "templateMessage": {
            "id": "IDTemplate"
        }
    },
    "origin": {
        "from": {
            "number": "+55NumeroOficial"
        }
    },
    "options": {
        "automaticAssign": true
    }
}
ActionScript
Copy

Lembrando que para enviar o valor da variável {nome-contato} deve-se utilizar o campo "name", pois é um campo padrão do Octadesk e não um campo de pessoa personalizado.