Pular para o conteúdo principal

Enviar documentos

Método#

/send-document/{extension}#

POST https://www.plugchat.com.br/api/whatsapp/send-document/ {extension}

Não se esqueça! Você precisa informar o parâmetro {extension} com a extensão do aquivo que deseja enviar ! Teóricamente este método deve suportar todos tipos de documentos, desde que eles estejam dentro das politícas de tamanho de aquivos do proprio Whatsaspp (para saber mais sobre estes limites clique aqui).

Tamanho e formatos#

O Whatsapp limita o tamanho de arquivos e sua politica muda constantemente, por isso sempre recomendamos a verificação direto no site do próprio Whatsapp.

Neste link você encontra tudo que precisa saber sobre formatos e tamanhos de arquivos.

Header#

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

KeyValue
Authorization:1nEFbU3EktLnV7LIIzX

Conceituação#

Método responsavel por enviar documentos aos seus contatos ele é simples e objetivo.


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
documentstringLink do documento ou seu Base64

Opcionais#

AtributosTipoDescrição
fileNameStringNome do documento
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": "5544999999999",
"document": "https://expoforest.com.br/wp-content/uploads/2017/05/exemplo.pdf",
"fileName": "Meu PDF"
}

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#