Skip to main content
GET
https://suasofia.online/api/
/
conversations
/
{uuid}
curl -X GET "https://suasofia.online/api/conversations/7c9e6679-7425-40de-944b-e07fc1f90ae7"

{
  "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"
          }
        }
      ]
    }
  ]
}
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

​
uuid
string
required
O identificador UUID único da conversa a recuperar

​
Campos de Resposta

​
status
boolean
Indica se a requisição foi bem-sucedida
​
history
array
Array de mensagens na conversa, ordenadas cronologicamente (mais antigas primeiro).

​
Respostas de Erro

​
status
boolean
Será false quando um erro ocorrer
​
error
string
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"

{
  "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"
          }
        }
      ]
    }
  ]
}

​
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