> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.callix.dev.br/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.callix.dev.br/_mcp/server.

# Usando a API para realizar chamadas (Click to Call)

Para iniciar chamadas automáticas usando a API é preciso utilizar a interface do sistema para gerar um\
[token de acesso](/introducao/visao-geral#autenticação) da API.

## 1. Iniciar uma chamada

Este endpoint permite iniciar uma chamada automática para um número específico através de um usuário/agente do sistema.

#### Exemplo de chamada:

```bash
curl -X POST "https://sua-conta.callix.com.br/api/v1/click_to_call" \
  -H "Authorization: Bearer SEU_TOKEN" \
  -H "Content-Type: application/vnd.api+json" \
  -d '{
  "data": {
    "type": "click_to_call",
    "attributes": {
      "user_id": "1",
      "phone": "18997405083"
    }
  }
}'
```

Na chamada, você deve fornecer:

* `user_id`: ID do agente que realizará a chamada
* `phone`: Número de telefone de destino (formato nacional ou internacional)

#### Exemplo de resposta:

```json
{
  "click_to_call_id": "654ab628-d964-4dc4-9beb-5defafe82d38",
  "message": "Call successfully sent"
}
```

O campo `click_to_call_id` é um identificador único gerado para rastrear a chamada no sistema.

## Atributos

### Atributos da Requisição

| Atributo  | Tipo   | Obrigatório | Descrição                            |
| --------- | ------ | ----------- | ------------------------------------ |
| `user_id` | string | Sim         | ID do agente que realizará a chamada |
| `phone`   | string | Sim         | Número de telefone de destino        |

### Atributos da Resposta

| Atributo           | Tipo   | Descrição                                  |
| ------------------ | ------ | ------------------------------------------ |
| `click_to_call_id` | string | ID único gerado para identificar a chamada |
| `message`          | string | Mensagem confirmando o sucesso da operação |

## Códigos de Resposta

| Código HTTP | Descrição                                                               |
| ----------- | ----------------------------------------------------------------------- |
| `200`       | Chamada enviada com sucesso                                             |
| `400`       | Requisição inválida (campos obrigatórios ausentes ou formato incorreto) |
| `401`       | Token de autenticação inválido ou ausente                               |
| `404`       | Usuário não encontrado                                                  |