curl -X GET "https://suasofia.online/api/conversations/7c9e6679-7425-40de-944b-e07fc1f90ae7"
const conversationId = '7c9e6679-7425-40de-944b-e07fc1f90ae7';
const response = await fetch(
`https://suasofia.online/api/conversations/${conversationId}`
);
const data = await response.json();
console.log(data.history);
import requests
conversation_id = '7c9e6679-7425-40de-944b-e07fc1f90ae7'
response = requests.get(
f'https://suasofia.online/api/conversations/{conversation_id}'
)
data = response.json()
print(data['history'])
{
"status": true,
"history": [
{
"role": "assistant",
"content": "Olá! Bem-vindo ao nosso suporte. Como posso ajudar você hoje?"
},
{
"role": "user",
"content": "Gostaria de agendar uma demonstração"
},
{
"role": "assistant",
"content": "Ficaria feliz em ajudar você a agendar uma demonstração! Tenho disponibilidade amanhã às 14h ou quinta-feira às 10h. Qual funciona melhor para você?",
"function_calls": [
{
"name": "check_calendar_availability",
"arguments": {
"date_range": "next_7_days"
},
"result": {
"available_slots": ["2025-01-10 14:00", "2025-01-12 10:00"]
}
}
]
},
{
"role": "user",
"content": "Quinta-feira às 10h funciona para mim"
},
{
"role": "assistant",
"content": "Agendei sua demonstração para quinta-feira, 12 de janeiro às 10h. Você receberá um convite do calendário em breve. Há algo específico que gostaria que cobrissemos durante a demonstração?",
"function_calls": [
{
"name": "book_appointment",
"arguments": {
"datetime": "2025-01-12T10:00:00",
"title": "Demonstração do Produto"
},
"result": {
"success": true,
"booking_id": "abc123"
}
}
]
}
]
}
{
"status": false,
"error": "Conversa não encontrada"
}
Conversas
Obter Conversa
Recuperar o histórico de mensagens de uma conversa
GET
/
conversations
/
{uuid}
curl -X GET "https://suasofia.online/api/conversations/7c9e6679-7425-40de-944b-e07fc1f90ae7"
const conversationId = '7c9e6679-7425-40de-944b-e07fc1f90ae7';
const response = await fetch(
`https://suasofia.online/api/conversations/${conversationId}`
);
const data = await response.json();
console.log(data.history);
import requests
conversation_id = '7c9e6679-7425-40de-944b-e07fc1f90ae7'
response = requests.get(
f'https://suasofia.online/api/conversations/{conversation_id}'
)
data = response.json()
print(data['history'])
{
"status": true,
"history": [
{
"role": "assistant",
"content": "Olá! Bem-vindo ao nosso suporte. Como posso ajudar você hoje?"
},
{
"role": "user",
"content": "Gostaria de agendar uma demonstração"
},
{
"role": "assistant",
"content": "Ficaria feliz em ajudar você a agendar uma demonstração! Tenho disponibilidade amanhã às 14h ou quinta-feira às 10h. Qual funciona melhor para você?",
"function_calls": [
{
"name": "check_calendar_availability",
"arguments": {
"date_range": "next_7_days"
},
"result": {
"available_slots": ["2025-01-10 14:00", "2025-01-12 10:00"]
}
}
]
},
{
"role": "user",
"content": "Quinta-feira às 10h funciona para mim"
},
{
"role": "assistant",
"content": "Agendei sua demonstração para quinta-feira, 12 de janeiro às 10h. Você receberá um convite do calendário em breve. Há algo específico que gostaria que cobrissemos durante a demonstração?",
"function_calls": [
{
"name": "book_appointment",
"arguments": {
"datetime": "2025-01-12T10:00:00",
"title": "Demonstração do Produto"
},
"result": {
"success": true,
"booking_id": "abc123"
}
}
]
}
]
}
{
"status": false,
"error": "Conversa não encontrada"
}
Este endpoint recupera o histórico completo de mensagens de uma conversa existente. Use para exibir mensagens anteriores ao retomar uma conversa ou para revisar o conteúdo da conversa.
Parâmetros do Caminho
string
required
O identificador UUID único da conversa a recuperar
Campos de Resposta
boolean
Indica se a requisição foi bem-sucedida
array
Array de mensagens na conversa, ordenadas cronologicamente (mais antigas primeiro).
Respostas de Erro
boolean
Será
false quando um erro ocorrerstring
Mensagem de erro. Valores possíveis:
Conversation not found- O UUID fornecido não corresponde a nenhuma conversa
curl -X GET "https://suasofia.online/api/conversations/7c9e6679-7425-40de-944b-e07fc1f90ae7"
const conversationId = '7c9e6679-7425-40de-944b-e07fc1f90ae7';
const response = await fetch(
`https://suasofia.online/api/conversations/${conversationId}`
);
const data = await response.json();
console.log(data.history);
import requests
conversation_id = '7c9e6679-7425-40de-944b-e07fc1f90ae7'
response = requests.get(
f'https://suasofia.online/api/conversations/{conversation_id}'
)
data = response.json()
print(data['history'])
{
"status": true,
"history": [
{
"role": "assistant",
"content": "Olá! Bem-vindo ao nosso suporte. Como posso ajudar você hoje?"
},
{
"role": "user",
"content": "Gostaria de agendar uma demonstração"
},
{
"role": "assistant",
"content": "Ficaria feliz em ajudar você a agendar uma demonstração! Tenho disponibilidade amanhã às 14h ou quinta-feira às 10h. Qual funciona melhor para você?",
"function_calls": [
{
"name": "check_calendar_availability",
"arguments": {
"date_range": "next_7_days"
},
"result": {
"available_slots": ["2025-01-10 14:00", "2025-01-12 10:00"]
}
}
]
},
{
"role": "user",
"content": "Quinta-feira às 10h funciona para mim"
},
{
"role": "assistant",
"content": "Agendei sua demonstração para quinta-feira, 12 de janeiro às 10h. Você receberá um convite do calendário em breve. Há algo específico que gostaria que cobrissemos durante a demonstração?",
"function_calls": [
{
"name": "book_appointment",
"arguments": {
"datetime": "2025-01-12T10:00:00",
"title": "Demonstração do Produto"
},
"result": {
"success": true,
"booking_id": "abc123"
}
}
]
}
]
}
{
"status": false,
"error": "Conversa não encontrada"
}
Casos de Uso
- Retomar conversas: Recuperar histórico quando um usuário retorna para continuar uma conversa
- Analytics: Revisar conteúdo de conversa para garantia de qualidade
- Integração: Sincronizar dados de conversa com seu CRM ou sistema de suporte
⌘I

