Skip to main content
POST
Este endpoint envia uma mensagem do usuário para uma conversa existente e retorna a resposta da assistente. A assistente processa a mensagem usando o modelo de IA configurado e quaisquer ferramentas disponíveis.

Parâmetros de Caminho

string
required
O identificador UUID único da conversa

Corpo da Requisição

string
required
A mensagem do usuário a ser enviada para a assistente. Comprimento máximo: 2000 caracteres.

Campos de Resposta

boolean
Indica se a requisição foi bem-sucedida
string
A resposta da assistente para a mensagem do usuário
array
Array de chamadas de função feitas pela assistente ao processar a mensagem. Array vazio se nenhuma função foi chamada.

Respostas de Erro

boolean
Será false quando um erro ocorrer
string
Mensagem de erro. Valores possíveis:
  • Conversa não encontrada - O UUID fornecido não corresponde a nenhuma conversa
  • Saldo insuficiente. Por favor, recarregue sua conta. - O saldo da conta do proprietário da assistente está muito baixo
  • Falha ao processar mensagem: [detalhes] - Ocorreu um erro ao processar a mensagem

Preços

Cada mensagem de usuário em uma conversa de widget custa R$0,01. Conversas de teste são gratuitas.

Chamadas de Função

A assistente pode executar funções durante o processamento da mensagem, como:
  • Operações de calendário: Verificando disponibilidade, agendando compromissos
  • Consultas em bases de conhecimento: Pesquisando documentação ou FAQs
  • Integrações personalizadas: Chamando seus endpoints de webhook configurados
Os resultados das chamadas de função estão incluídos na resposta para que você possa exibir informações relevantes para o usuário ou rastrear ações realizadas.

Melhores Práticas

  1. Trate erros de forma amigável: Exiba mensagens amigáveis ao usuário quando erros ocorrerem
  2. Mostre estados de carregamento: A assistente pode levar alguns segundos para responder, especialmente ao executar funções
  3. Preserve o ID da conversa: Armazene o UUID da conversa para permitir que os usuários retomem conversas
  4. Respeite os limites de taxa: Implemente atrasos apropriados entre mensagens, se necessário