Enviar arquivo
/contacts/{contact_id}/send/fileEnvia ao contato uma imagem, um vídeo, um áudio ou um documento, a partir do endereço do arquivo. Os formatos e os tamanhos aceitos mudam de canal para canal: veja Tipos de arquivo e limites por canal e Enviar texto, imagem e arquivo.
No WhatsApp, a mensagem livre só sai até 24 horas depois da última mensagem do contato. Fora dessa janela, use Enviar fluxo com um fluxo que comece com um Modelo de Mensagem aprovado. Veja A janela de 24 horas e, para o Instagram e o Messenger, Mensagens fora da janela.
curl -X POST "https://app.nextagsai.com.br/api/contacts/123456789/send/file" \
-H "X-ACCESS-TOKEN: $NEXTAGS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"url": "https://exemplo.com.br/arquivos/catalogo.pdf",
"type": "file",
"channel": "whatsapp"
}'const resposta = await fetch('https://app.nextagsai.com.br/api/contacts/123456789/send/file', {
method: 'POST',
headers: {
'X-ACCESS-TOKEN': process.env.NEXTAGS_API_KEY,
'Content-Type': 'application/json',
},
body: JSON.stringify({
url: 'https://exemplo.com.br/arquivos/catalogo.pdf',
type: 'file',
channel: 'whatsapp',
}),
});
const dados = await resposta.json();
console.log(resposta.status, dados);import os
import requests
resposta = requests.post(
"https://app.nextagsai.com.br/api/contacts/123456789/send/file",
headers={"X-ACCESS-TOKEN": os.environ["NEXTAGS_API_KEY"]},
json={
"url": "https://exemplo.com.br/arquivos/catalogo.pdf",
"type": "file",
"channel": "whatsapp",
},
timeout=30,
)
print(resposta.status_code, resposta.json())<?php
$ch = curl_init('https://app.nextagsai.com.br/api/contacts/123456789/send/file');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_HTTPHEADER => [
'X-ACCESS-TOKEN: ' . getenv('NEXTAGS_API_KEY'),
'Content-Type: application/json',
],
CURLOPT_POSTFIELDS => json_encode([
'url' => 'https://exemplo.com.br/arquivos/catalogo.pdf',
'type' => 'file',
'channel' => 'whatsapp',
]),
]);
$dados = json_decode(curl_exec($ch), true);
echo curl_getinfo($ch, CURLINFO_HTTP_CODE), PHP_EOL;
print_r($dados);Autenticação
Mande a chave de API da conta no cabeçalho X-ACCESS-TOKEN de cada chamada. Veja Autenticação com a chave de API.
Parâmetros de caminho
contact_idintegerobrigatórioO ID do contato que recebe.
Corpo da requisição
JSONContent-Type: application/json
urlstringobrigatórioO endereço público do arquivo, que abra sem login.
Exemplo: https://exemplo.com.br/arquivos/catalogo.pdf
typestringobrigatórioO tipo do arquivo: image (imagem), video (vídeo), audio (áudio) ou file (documento).
Valores: file image audio video
channelstringPor qual canal o arquivo sai.
Valores: messenger whatsapp telegram instagram
Respostas
O envio foi aceito.
successbooleantrue quando a NexTags aceitou o envio.
A chave de API não veio no cabeçalho ou não vale (foi excluída ou está incompleta). Veja Autenticação.
Relacionados
Enviar texto, imagem e arquivo
Guia que usa este endpointTipos de arquivo e limites por canal
Tutorial da Central de AjudaEnviar arquivos, imagens e áudios (e a biblioteca de mídia)
Tutorial da Central de AjudaImagem, vídeo, áudio, GIF e arquivo
Tutorial da Central de AjudaEnviar fluxo
POST /contacts/{contact_id}/send/{flow_id}Enviar texto
POST /contacts/{contact_id}/send/textEste conteúdo ajudou?
Obrigado! Sua resposta ajuda a melhorar a central.