Pular para o conteúdo principal

Enviar link

Método#

/send-link#

POST https://www.plugchat.com.br/api/whatsapp/send-link

Header#

Toda requisição http feita precisa passar sua header de autorização.#

KeyValue
Authorization:1nEFbU3EktLnV7LIIzX

Conceituação#

Método responsavel por enviar um link aos seus contatos, muito utilzado para compartilhar links para que os usuários sejam direcionados a um site.

Sobre links

É importante você saber que o link só fica clicavel caso o destinatário ja tenha seu telefone nos contatos, ou se o mesmo iniciar uma conversa com vocë.


Atributos#

Obrigatórios#

AtributosTipoDescrição
phonestringTelefone (ou ID do grupo para casos de envio para grupos) do destinatário no formato DDI DDD NUMERO Ex: 551199999999. IMPORTANTE Envie somente números, sem formatação ou máscara
messagestringTexto sobre seu link. Não esqueça de informar o mesmo valor do linkURL no final deste texto.
imagestringLink da imagem
linkUrlstringUrl do seu link
titlestringTitulo para o link
linkDescriptionstringdescrição do link

Opcionais#

AtributosTipoDescrição
messageIdStringAtributo utilizado para responder uma mensagem do chat, basta adicionar o messageId da mensagem que queira responder neste atributo
delayMessagenumberNesse atributo um delay é adicionado na mensagem. Você pode decidir entre um range de 1~15 sec, significa quantos segundos ele vai esperar para enviar a próxima mensagem. (Ex "delayMessage": 5, ). O delay default caso não seja informado é de 1~3 sec

Request Body#

{
"phone": "5511999998888",
"message": "Aqui você coloca um texto sobre o site, atenção esse texto preciso ter o link que será enviado no final da mensagem! Assim: https://www.plugchat.com.br/",
"image": "https://firebasestorage.googleapis.com/v0/b/zaap-messenger-web.appspot.com/o/logo.png?alt=media",
"linkUrl": "https://www.plugchat.com.br/",
"title": "Plug Chat",
"linkDescription": "Centralize Seu Atendimento No Whatsapp Com Plug Chat"
}

Response#

200#

AtributosTipoDescrição
zaapIdstringid no plug
messageIdstringid no whatsapp

Exemplo

{
"zaapId": "3999984263738042930CD6ECDE9VDWSA",
"messageId": "D241XXXX732339502B68"
}

405#

Neste caso certifique que esteja enviando o corretamente a especificação do método, ou seja verifique se você enviou o POST ou GET conforme especificado no inicio deste tópico.

415#

Caso você receba um erro 415, certifique de adicionar na headers da requisição o "Content-Type" do objeto que você está enviando, em sua grande maioria "application/json"


Code#