Enviar texto
/contacts/{contact_id}/send/textEnvia uma mensagem de texto ao contato. Para mandar mais de uma mensagem, botões ou ações na mesma chamada, use Enviar conteúdo. Veja 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/text" \
-H "X-ACCESS-TOKEN: $NEXTAGS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"text": "Oi, Ana! Seu pedido PED-1001 saiu para entrega.",
"channel": "whatsapp"
}'const resposta = await fetch('https://app.nextagsai.com.br/api/contacts/123456789/send/text', {
method: 'POST',
headers: {
'X-ACCESS-TOKEN': process.env.NEXTAGS_API_KEY,
'Content-Type': 'application/json',
},
body: JSON.stringify({
text: 'Oi, Ana! Seu pedido PED-1001 saiu para entrega.',
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/text",
headers={"X-ACCESS-TOKEN": os.environ["NEXTAGS_API_KEY"]},
json={
"text": "Oi, Ana! Seu pedido PED-1001 saiu para entrega.",
"channel": "whatsapp",
},
timeout=30,
)
print(resposta.status_code, resposta.json())<?php
$ch = curl_init('https://app.nextagsai.com.br/api/contacts/123456789/send/text');
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([
'text' => 'Oi, Ana! Seu pedido PED-1001 saiu para entrega.',
'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
textstringobrigatórioO texto da mensagem.
Exemplo: Oi, Ana! Seu pedido PED-1001 saiu para entrega.
channelstringPor qual canal a mensagem sai.
Valores: messenger whatsapp webchat 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 endpointResponder uma conversa
Tutorial da Central de AjudaTexto, botões e respostas rápidas
Tutorial da Central de AjudaEnviar fluxo
POST /contacts/{contact_id}/send/{flow_id}Enviar arquivo
POST /contacts/{contact_id}/send/fileEnviar conteúdo
POST /contacts/{contact_id}/send_contentEste conteúdo ajudou?
Obrigado! Sua resposta ajuda a melhorar a central.