curl -X POST "https://suasofia.online/api/conversations/7c9e6679-7425-40de-944b-e07fc1f90ae7/messages" \
-H "Content-Type: application/json" \
-d '{
"message": "Gostaria de agendar uma demonstração para a próxima semana"
}'
const conversationId = '7c9e6679-7425-40de-944b-e07fc1f90ae7';
const response = await fetch(
`https://suasofia.online/api/conversations/${conversationId}/messages`,
{
method: 'POST',
headers: {
'Content-Type': 'application/json',
},
body: JSON.stringify({
message: 'Gostaria de agendar uma demonstração para a próxima semana'
})
}
);
const data = await response.json();
console.log(data.message);
import requests
conversation_id = '7c9e6679-7425-40de-944b-e07fc1f90ae7'
response = requests.post(
f'https://suasofia.online/api/conversations/{conversation_id}/messages',
json={
'message': 'Gostaria de agendar uma demonstração para a próxima semana'
}
)
data = response.json()
print(data['message'])
{
"status": true,
"message": "Ficarei feliz em ajudá-lo a agendar uma demonstração! Tenho disponibilidade na segunda-feira às 14h, na quarta-feira às 10h ou na sexta-feira às 15h. Qual horário funciona melhor para você?",
"function_calls": []
}
{
"status": true,
"message": "Verifiquei nosso calendário e encontrei vários horários disponíveis para a próxima semana. Posso oferecer segunda-feira às 14h, quarta-feira às 10h ou sexta-feira às 15h. Qual você prefere?",
"function_calls": [
{
"name": "check_calendar_availability",
"arguments": {
"start_date": "2025-01-13",
"end_date": "2025-01-17"
},
"result": {
"available_slots": [
"2025-01-13 14:00",
"2025-01-15 10:00",
"2025-01-17 15:00"
]
}
}
]
}
{
"status": false,
"error": "Conversa não encontrada"
}
{
"status": false,
"error": "Saldo insuficiente. Por favor, recarregue sua conta."
}
{
"status": false,
"error": "Falha ao processar mensagem: Tempo de conexão esgotado"
}
{
"message": "O campo mensagem é obrigatório.",
"errors": {
"message": ["O campo mensagem é obrigatório."]
}
}
Conversas
Enviar Mensagem
Envie uma mensagem em uma conversa existente e receba a resposta da assistente
POST
/
conversations
/
{uuid}
/
messages
curl -X POST "https://suasofia.online/api/conversations/7c9e6679-7425-40de-944b-e07fc1f90ae7/messages" \
-H "Content-Type: application/json" \
-d '{
"message": "Gostaria de agendar uma demonstração para a próxima semana"
}'
const conversationId = '7c9e6679-7425-40de-944b-e07fc1f90ae7';
const response = await fetch(
`https://suasofia.online/api/conversations/${conversationId}/messages`,
{
method: 'POST',
headers: {
'Content-Type': 'application/json',
},
body: JSON.stringify({
message: 'Gostaria de agendar uma demonstração para a próxima semana'
})
}
);
const data = await response.json();
console.log(data.message);
import requests
conversation_id = '7c9e6679-7425-40de-944b-e07fc1f90ae7'
response = requests.post(
f'https://suasofia.online/api/conversations/{conversation_id}/messages',
json={
'message': 'Gostaria de agendar uma demonstração para a próxima semana'
}
)
data = response.json()
print(data['message'])
{
"status": true,
"message": "Ficarei feliz em ajudá-lo a agendar uma demonstração! Tenho disponibilidade na segunda-feira às 14h, na quarta-feira às 10h ou na sexta-feira às 15h. Qual horário funciona melhor para você?",
"function_calls": []
}
{
"status": true,
"message": "Verifiquei nosso calendário e encontrei vários horários disponíveis para a próxima semana. Posso oferecer segunda-feira às 14h, quarta-feira às 10h ou sexta-feira às 15h. Qual você prefere?",
"function_calls": [
{
"name": "check_calendar_availability",
"arguments": {
"start_date": "2025-01-13",
"end_date": "2025-01-17"
},
"result": {
"available_slots": [
"2025-01-13 14:00",
"2025-01-15 10:00",
"2025-01-17 15:00"
]
}
}
]
}
{
"status": false,
"error": "Conversa não encontrada"
}
{
"status": false,
"error": "Saldo insuficiente. Por favor, recarregue sua conta."
}
{
"status": false,
"error": "Falha ao processar mensagem: Tempo de conexão esgotado"
}
{
"message": "O campo mensagem é obrigatório.",
"errors": {
"message": ["O campo mensagem é obrigatório."]
}
}
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
Respostas de Erro
boolean
Será
false quando um erro ocorrerstring
Mensagem de erro. Valores possíveis:
Conversa não encontrada- O UUID fornecido não corresponde a nenhuma conversaSaldo insuficiente. Por favor, recarregue sua conta.- O saldo da conta do proprietário da assistente está muito baixoFalha ao processar mensagem: [detalhes]- Ocorreu um erro ao processar a mensagem
curl -X POST "https://suasofia.online/api/conversations/7c9e6679-7425-40de-944b-e07fc1f90ae7/messages" \
-H "Content-Type: application/json" \
-d '{
"message": "Gostaria de agendar uma demonstração para a próxima semana"
}'
const conversationId = '7c9e6679-7425-40de-944b-e07fc1f90ae7';
const response = await fetch(
`https://suasofia.online/api/conversations/${conversationId}/messages`,
{
method: 'POST',
headers: {
'Content-Type': 'application/json',
},
body: JSON.stringify({
message: 'Gostaria de agendar uma demonstração para a próxima semana'
})
}
);
const data = await response.json();
console.log(data.message);
import requests
conversation_id = '7c9e6679-7425-40de-944b-e07fc1f90ae7'
response = requests.post(
f'https://suasofia.online/api/conversations/{conversation_id}/messages',
json={
'message': 'Gostaria de agendar uma demonstração para a próxima semana'
}
)
data = response.json()
print(data['message'])
{
"status": true,
"message": "Ficarei feliz em ajudá-lo a agendar uma demonstração! Tenho disponibilidade na segunda-feira às 14h, na quarta-feira às 10h ou na sexta-feira às 15h. Qual horário funciona melhor para você?",
"function_calls": []
}
{
"status": true,
"message": "Verifiquei nosso calendário e encontrei vários horários disponíveis para a próxima semana. Posso oferecer segunda-feira às 14h, quarta-feira às 10h ou sexta-feira às 15h. Qual você prefere?",
"function_calls": [
{
"name": "check_calendar_availability",
"arguments": {
"start_date": "2025-01-13",
"end_date": "2025-01-17"
},
"result": {
"available_slots": [
"2025-01-13 14:00",
"2025-01-15 10:00",
"2025-01-17 15:00"
]
}
}
]
}
{
"status": false,
"error": "Conversa não encontrada"
}
{
"status": false,
"error": "Saldo insuficiente. Por favor, recarregue sua conta."
}
{
"status": false,
"error": "Falha ao processar mensagem: Tempo de conexão esgotado"
}
{
"message": "O campo mensagem é obrigatório.",
"errors": {
"message": ["O campo mensagem é obrigatório."]
}
}
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
Melhores Práticas
- Trate erros de forma amigável: Exiba mensagens amigáveis ao usuário quando erros ocorrerem
- Mostre estados de carregamento: A assistente pode levar alguns segundos para responder, especialmente ao executar funções
- Preserve o ID da conversa: Armazene o UUID da conversa para permitir que os usuários retomem conversas
- Respeite os limites de taxa: Implemente atrasos apropriados entre mensagens, se necessário

