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

# Faça Sua Primeira Chamada

> Tutorial passo a passo para fazer sua primeira chamada com IA usando o Talkover

# Faça Sua Primeira Chamada

Este tutorial irá guiá-lo através da criação de sua primeira chamada com IA usando a API Talkover. Você aprenderá como obter seu ID do agente e fazer uma chamada de teste.

## Pré-requisitos

Antes de começar este tutorial, certifique-se de ter:

* **Token de Ambiente** (do [Guia de Autenticação](/pt-br/getting-started/authentication))
* **Agente de Voz Criado** (do [Guia de Início Rápido](/pt-br/getting-started/quickstart))
* **Número de Telefone de Teste** pronto para receber chamadas

## Passo 1: Obter Seu ID do Agente

Você precisa do seu ID do agente para fazer chamadas. Aqui está como encontrá-lo:

### Do Painel:

1. **Faça login** no seu painel Talkover em [app.talkover.ai](https://app.talkover.ai)
2. **Vá para Agentes de Voz** na barra lateral esquerda
3. **Encontre seu agente** na lista
4. **Clique no agente** para ver detalhes
5. **Copie o ID do Agente** (parece com `agent_123456`)

<Info>
  O ID do Agente é exibido na página de detalhes do agente e é necessário para todas as chamadas da API.
</Info>

## Passo 2: Preparar Sua Solicitação da API

Agora você tem tudo que precisa para fazer sua primeira chamada:

* **Token de Ambiente**: `talq_seu_token_aqui`
* **ID do Agente**: `agent_123456`
* **Número de Telefone**: `+5511987654321`

### Endpoints da API

#### Chamada Individual do Agente

```
POST https://app.talkover.ai/api/v1/agents/{agent_id}/call
```

#### Chamada de Campanha

```
POST https://app.talkover.ai/api/v1/campaigns/{campaign_id}/call
```

### Cabeçalhos da Solicitação

```bash theme={null}
Authorization: Bearer talq_seu_token_aqui
Content-Type: application/json
```

### Corpo da Solicitação

#### Para Chamadas de Agente

```json theme={null}
{
  "to": "+5511987654321"
}
```

#### Para Chamadas de Campanha

```json theme={null}
{
  "to": "+5511987654321",
  "payload": {
    "customer_name": "João Silva",
    "customer_id": "12345"
  }
}
```

## Passo 3: Fazer a Chamada

### Usando cURL

```bash theme={null}
curl -X POST "https://app.talkover.ai/api/v1/agents/agent_123456/call" \
  -H "Authorization: Bearer talq_seu_token_aqui" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+5511987654321"
  }'
```

### Usando JavaScript

```javascript theme={null}
const makeCall = async () => {
  const response = await fetch('https://app.talkover.ai/api/v1/agents/agent_123456/call', {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer talq_seu_token_aqui',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      to: '+5511987654321'
    })
  });
  
  const result = await response.json();
  console.log('Chamada iniciada:', result);
};

makeCall();
```

### Usando Python

```python theme={null}
import requests

def make_call():
    url = "https://app.talkover.ai/api/v1/agents/agent_123456/call"
    headers = {
        "Authorization": "Bearer talq_seu_token_aqui",
        "Content-Type": "application/json"
    }
    data = {
        "to": "+5511987654321"
    }
    
    response = requests.post(url, headers=headers, json=data)
    result = response.json()
    print("Chamada iniciada:", result)

make_call()
```

## Passo 4: Entender a Resposta

Quando você iniciar uma chamada com sucesso, receberá uma resposta como esta:

```json theme={null}
{
  "call_id": "call_789012",
  "agent_id": "agent_123456",
  "to": "+5511987654321",
  "status": "initiated",
  "created_at": "2024-01-15T10:30:00Z",
  "estimated_duration": 120
}
```

### Campos da Resposta Explicados:

* **`call_id`**: Identificador único para esta chamada
* **`agent_id`**: O agente que irá lidar com a chamada
* **`to`**: O número de telefone sendo chamado
* **`status`**: Status atual da chamada (`initiated`, `ringing`, `in-progress`, `completed`, `failed`)
* **`created_at`**: Timestamp quando a chamada foi criada
* **`estimated_duration`**: Duração estimada da chamada em segundos

## Passo 5: Monitorar Sua Chamada

### Verificar Status da Chamada no Painel

1. **Vá para Chamadas** no seu painel
2. **Encontre sua chamada** por ID da chamada ou número de telefone
3. **Monitore o status** conforme progride:
   * `initiated` → `ringing` → `in-progress` → `completed`

### Fluxo de Status da Chamada

```
initiated → ringing → in-progress → completed
     ↓         ↓           ↓           ↓
   Chamada  Telefone   Agente está   Chamada
  criada    tocando    conversando  terminou
```

## Passo 6: Testar Diferentes Cenários

### Testar com Diferentes Números de Telefone

Tente chamar números diferentes para testar vários cenários:

```bash theme={null}
# Testar com um número móvel
curl -X POST "https://app.talkover.ai/api/v1/agents/agent_123456/call" \
  -H "Authorization: Bearer talq_seu_token_aqui" \
  -H "Content-Type: application/json" \
  -d '{"to": "+5511999999999"}'

# Testar com um telefone fixo
curl -X POST "https://app.talkover.ai/api/v1/agents/agent_123456/call" \
  -H "Authorization: Bearer talq_seu_token_aqui" \
  -H "Content-Type: application/json" \
  -d '{"to": "+5511888888888"}'
```

### Testar Tratamento de Erros

Tente chamar um número inválido para ver respostas de erro:

```bash theme={null}
curl -X POST "https://app.talkover.ai/api/v1/agents/agent_123456/call" \
  -H "Authorization: Bearer talq_seu_token_aqui" \
  -H "Content-Type: application/json" \
  -d '{"to": "numero_invalido"}'
```

## Solução de Problemas

### Problemas Comuns

| Problema                | Solução                                                             |
| ----------------------- | ------------------------------------------------------------------- |
| **401 Unauthorized**    | Verifique se seu token de ambiente está correto                     |
| **404 Not Found**       | Verifique se seu ID do agente está correto                          |
| **400 Bad Request**     | Verifique o formato do número de telefone (deve ser +5511987654321) |
| **Chamada não tocando** | Verifique se o número de telefone é válido e pode receber chamadas  |

### Dicas de Depuração

1. **Verifique a resposta** para mensagens de erro
2. **Verifique se seu agente** está configurado corretamente
3. **Teste com um número conhecido** primeiro
4. **Verifique seu painel** para atualizações de status da chamada

## Próximos Passos

Parabéns! Você fez sua primeira chamada com IA com sucesso. Aqui está o que você pode explorar a seguir:

* **Projete melhores fluxos de chamada** em nosso [Guia de Design de Fluxo de Chamadas](/pt-br/guides/call-flow-design)
* **Integre com sua aplicação** usando nossos [Exemplos de Integração](/pt-br/guides/integration-examples)
* **Aprenda sobre analytics de chamadas** e monitoramento

<Check>
  🎉 Você fez sua primeira chamada com o Talkover com sucesso! Seu agente de voz com IA agora está pronto para lidar com conversas.
</Check>