> ## Documentation Index
> Fetch the complete documentation index at: https://docs.suasofia.online/llms.txt
> Use this file to discover all available pages before exploring further.

# Obter Conversa

> Recuperar o histórico de mensagens de uma conversa

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

<ParamField path="uuid" type="string" required>
  O identificador UUID único da conversa a recuperar
</ParamField>

### Campos de Resposta

<ResponseField name="status" type="boolean">
  Indica se a requisição foi bem-sucedida
</ResponseField>

<ResponseField name="history" type="array">
  Array de mensagens na conversa, ordenadas cronologicamente (mais antigas primeiro).

  <Expandable title="Propriedades do objeto de mensagem">
    <ResponseField name="role" type="string">
      O papel da mensagem: `assistant` ou `user`
    </ResponseField>

    <ResponseField name="content" type="string">
      O conteúdo da mensagem
    </ResponseField>

    <ResponseField name="function_calls" type="array">
      Opcional. Array de chamadas de função feitas pelo assistente durante esta mensagem (ex.: agendamentos de calendário, chamadas de API).
    </ResponseField>
  </Expandable>
</ResponseField>

### Respostas de Erro

<ResponseField name="status" type="boolean">
  Será `false` quando um erro ocorrer
</ResponseField>

<ResponseField name="error" type="string">
  Mensagem de erro. Valores possíveis:

  * `Conversation not found` - O UUID fornecido não corresponde a nenhuma conversa
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://suasofia.online/api/conversations/7c9e6679-7425-40de-944b-e07fc1f90ae7"
  ```

  ```javascript JavaScript theme={null}
  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);
  ```

  ```python Python theme={null}
  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'])
  ```
</RequestExample>

<ResponseExample>
  ```json 200 Sucesso theme={null}
  {
    "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"
            }
          }
        ]
      }
    ]
  }
  ```

  ```json 404 Não Encontrado theme={null}
  {
    "status": false,
    "error": "Conversa não encontrada"
  }
  ```
</ResponseExample>

## 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