Método
/send-document/{extension}
POST
https://speedchat.dev.br/api/whatsapp/send-document/ {extension}
Não se esqueça! Você precisa informar o parâmetro {extension} com a extensão do arquivo que deseja enviar ! Teoricamente este método deve suportar todos tipos de documentos, desde que eles estejam dentro das politicas de tamanho de arquivos do próprio 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.
Key | Value |
---|---|
Authorization: | 1nEFbU3EktLnV7LIIzX |
Conceituação
Método responsável por enviar documentos aos seus contatos ele é simples e objetivo.
Atributos
Obrigatórios
Atributos | Tipo | Descrição |
---|---|---|
phone | string | Telefone (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 |
document | string | Link do documento ou seu Base64 |
Opcionais
Atributos | Tipo | Descrição |
---|---|---|
fileName | String | Nome do documento |
messageId | String | Atributo utilizado para responder uma mensagem do chat, basta adicionar o messageId da mensagem que queira responder neste atributo |
delayMessage | number | Nesse 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
Response
200
Atributos | Tipo | Descrição |
---|---|---|
zaapId | string | id no speedchat |
messageId | string | id no whatsapp |
Exemplo
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
Exemplo:
C#
var client = new RestClient("https://www.speedchat.dev.br/api/whatsapp/send-document/pdf");
var request = new RestRequest(Method.POST);
request.AddHeader("content-type", "application/json");
request.AddHeader("authorization", "TOKEN");
request.AddParameter("undefined", "{\"phone\": \"5511999998888\", \"document\": \"https://expoforest.com.br/wp-content/uploads/2017/05/exemplo.pdf\", \"fileName\": \"Meu PDF\"}", ParameterType.RequestBody);
IRestResponse response = client.Execute(request);
PHP
<?php
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => "https://www.speedchat.dev.br/api/whatsapp/send-document/pdf",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => "{\"phone\": \"5511999998888\", \"document\": \"https://expoforest.com.br/wp-content/uploads/2017/05/exemplo.pdf\", \"fileName\": \"Meu PDF\"}",
CURLOPT_HTTPHEADER => array(
"authorization: TOKEN",
"content-type: application/json"
),
));
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}
Node.js
var http = require("https");
var options = {
"method": "POST",
"hostname": "speedchat.dev.com.br",
"port": null,
"path": "/api/whatsapp/send-document/pdf",
"headers": {
"authorization": "TOKEN"
}
};
var req = http.request(options, function (res) {
var chunks = [];
res.on("data", function (chunk) {
chunks.push(chunk);
});
res.on("end", function () {
var body = Buffer.concat(chunks);
console.log(body.toString());
});
});
req.write(JSON.stringify({
phone: '5511999998888',
document: 'https://expoforest.com.br/wp-content/uploads/2017/05/exemplo.pdf',
fileName: 'Meu PDF'
}));
req.end();
Comentários
0 comentário
Por favor, entre para comentar.