Salvar mensagens no histórico da IA
/contacts/{contact_id}/ai/save_messagesPõe mensagens no histórico de conversa que a IA guarda do contato, sem enviar nada a ele. Use para dar contexto à IA sobre uma conversa que aconteceu fora da NexTags, como um atendimento por telefone, por e-mail ou na loja: nas próximas respostas, ela já sabe o que foi dito. Nos fluxos, a ação Excluir histórico de mensagens apaga o histórico da IA do contato; veja Chamar a IA no fluxo.
curl -X POST "https://app.nextagsai.com.br/api/contacts/123456789/ai/save_messages" \
-H "X-ACCESS-TOKEN: $NEXTAGS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"messages": [
{
"role": "user",
"type": "text",
"text": "Liguei ontem para trocar o tamanho do tênis do pedido PED-1001."
},
{
"role": "assistant",
"type": "text",
"text": "Combinado, Ana! A troca para o 38 foi aberta e o novo par sai amanhã."
}
]
}'const resposta = await fetch('https://app.nextagsai.com.br/api/contacts/123456789/ai/save_messages', {
method: 'POST',
headers: {
'X-ACCESS-TOKEN': process.env.NEXTAGS_API_KEY,
'Content-Type': 'application/json',
},
body: JSON.stringify({
messages: [
{
role: 'user',
type: 'text',
text: 'Liguei ontem para trocar o tamanho do tênis do pedido PED-1001.',
},
{
role: 'assistant',
type: 'text',
text: 'Combinado, Ana! A troca para o 38 foi aberta e o novo par sai amanhã.',
},
],
}),
});
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/ai/save_messages",
headers={"X-ACCESS-TOKEN": os.environ["NEXTAGS_API_KEY"]},
json={
"messages": [
{
"role": "user",
"type": "text",
"text": "Liguei ontem para trocar o tamanho do tênis do pedido PED-1001.",
},
{
"role": "assistant",
"type": "text",
"text": "Combinado, Ana! A troca para o 38 foi aberta e o novo par sai amanhã.",
},
],
},
timeout=30,
)
print(resposta.status_code, resposta.json())<?php
$ch = curl_init('https://app.nextagsai.com.br/api/contacts/123456789/ai/save_messages');
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([
'messages' => [
[
'role' => 'user',
'type' => 'text',
'text' => 'Liguei ontem para trocar o tamanho do tênis do pedido PED-1001.',
],
[
'role' => 'assistant',
'type' => 'text',
'text' => 'Combinado, Ana! A troca para o 38 foi aberta e o novo par sai amanhã.',
],
],
]),
]);
$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.
Corpo da requisição
JSONContent-Type: application/json
messagesarray de objectAs mensagens, na ordem em que aconteceram.
messages[].textstringobrigatórioO texto da mensagem.
Exemplo: Liguei ontem para trocar o tamanho do tênis do pedido PED-1001.
messages[].typestringO tipo: text (texto), image (imagem), file (arquivo) ou audio (áudio).
Valores: text image file audio
Exemplo: text
messages[].rolestringobrigatórioQuem falou: user (o contato), assistant (a IA ou a sua equipe, respondendo) ou developer (uma instrução para a IA, que não é fala de ninguém).
Valores: assistant user developer
Exemplo: user
Respostas
As mensagens entraram no histórico da IA do contato.
A chave de API não veio no cabeçalho ou não vale (foi excluída ou está incompleta). Veja Autenticação.
Relacionados
Este conteúdo ajudou?
Obrigado! Sua resposta ajuda a melhorar a central.