> ## 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 ligação

> Recuperar detalhes de uma ligação específica por ID.

Este endpoint permite recuperar informações detalhadas sobre uma ligação específica pertencente ao usuário autenticado.

### Parâmetros do Caminho

<ParamField path="id" type="integer" required>
  O identificador único da ligação
</ParamField>

### Campos de Resposta

<ResponseField name="id" type="integer">
  O identificador único da ligação
</ResponseField>

<ResponseField name="assistant_name" type="string">
  O nome do assistente que atendeu a ligação
</ResponseField>

<ResponseField name="campaign_name" type="string">
  O nome da campanha à qual esta ligação pertence (se aplicável)
</ResponseField>

<ResponseField name="type" type="string">
  O tipo da ligação (`inbound`, `outbound` ou `web`)
</ResponseField>

<ResponseField name="duration" type="integer">
  A duração da ligação em segundos
</ResponseField>

<ResponseField name="assistant_phone_number" type="string">
  O número de telefone usado pelo assistente
</ResponseField>

<ResponseField name="client_phone_number" type="string">
  O número de telefone do cliente
</ResponseField>

<ResponseField name="status" type="string">
  O status atual da ligação
</ResponseField>

<ResponseField name="transcript" type="string">
  A transcrição da conversa da ligação
</ResponseField>

<ResponseField name="variables" type="object">
  Variáveis coletadas durante a ligação
</ResponseField>

<ResponseField name="evaluation" type="object">
  Dados de avaliação do desempenho da ligação
</ResponseField>

<ResponseField name="webhook_response" type="object">
  Resposta de quaisquer webhooks configurados
</ResponseField>

<ResponseField name="carrier_cost" type="number">
  O custo cobrado pela operadora para esta ligação
</ResponseField>

<ResponseField name="total_cost" type="number">
  O custo total da ligação incluindo todas as taxas
</ResponseField>

<ResponseField name="answered_by" type="string">
  Quem atendeu a ligação (`human`, `machine` ou `unknown`)
</ResponseField>

<ResponseField name="recording_url" type="string">
  URL para a gravação da ligação (se disponível e ativada)
</ResponseField>

<ResponseField name="created_at" type="string">
  A data e hora quando a ligação foi criada
</ResponseField>

<ResponseField name="updated_at" type="string">
  A data e hora quando a ligação foi atualizada pela última vez
</ResponseField>

<ResponseExample>
  ```json 200 Resposta theme={null}
  {
    "id": 123,
    "assistant_name": "Assistente de Vendas",
    "campaign_name": "Campanha de Alcance Q4",
    "type": "outbound",
    "duration": 245,
    "assistant_phone_number": "+1234567890",
    "client_phone_number": "+1987654321",
    "status": "completed",
    "transcript": "Olá, aqui é a Sara da Sua SofIA. Como você está hoje?...",
    "variables": {
      "customer_name": "João Silva",
      "interest_level": "high",
      "follow_up_date": "2025-08-15"
    },
    "evaluation": {
      "sentiment": "positive",
      "outcome": "qualified_lead",
      "score": 8.5
    },
    "webhook_response": {
      "status": "success",
      "data": {
        "crm_contact_id": "abc123"
      }
    },
    "carrier_cost": 0.02,
    "total_cost": 0.025,
    "answered_by": "human",
    "recording_url": "https://recordings.suasofia.online/calls/123.mp3",
    "created_at": "2025-08-04 14:30:00",
    "updated_at": "2025-08-04 14:34:05"
  }
  ```

  ```json 404 Resposta theme={null}
  {
    "message": "Ligação não encontrada"
  }
  ```
</ResponseExample>