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)
Agente de Voz Criado (do Guia de Início Rápido)
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:

Faça login no seu painel Talkover em app.talkover.ai
Vá para Agentes de Voz na barra lateral esquerda
Encontre seu agente na lista
Clique no agente para ver detalhes
Copie o ID do Agente (parece com agent_123456)

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

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

Authorization: Bearer talq_seu_token_aqui
Content-Type: application/json

Corpo da Solicitação

Para Chamadas de Agente

{
  "to": "+5511987654321"
}

Para Chamadas de Campanha

{
  "to": "+5511987654321",
  "payload": {
    "customer_name": "João Silva",
    "customer_id": "12345"
  }
}

Passo 3: Fazer a Chamada

Usando cURL

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

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

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:

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

Vá para Chamadas no seu painel
Encontre sua chamada por ID da chamada ou número de telefone
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:

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

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

Verifique a resposta para mensagens de erro
Verifique se seu agente está configurado corretamente
Teste com um número conhecido primeiro
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
Integre com sua aplicação usando nossos Exemplos de Integração
Aprenda sobre analytics de chamadas e monitoramento

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

Primeiros Passos

Conceitos

Referência da API

Guias

Faça Sua Primeira Chamada

Faça Sua Primeira Chamada

Pré-requisitos

Passo 1: Obter Seu ID do Agente

Do Painel:

Passo 2: Preparar Sua Solicitação da API

Endpoints da API

Chamada Individual do Agente

Chamada de Campanha

Cabeçalhos da Solicitação

Corpo da Solicitação

Para Chamadas de Agente

Para Chamadas de Campanha

Passo 3: Fazer a Chamada

Usando cURL

Usando JavaScript

Usando Python

Passo 4: Entender a Resposta

Campos da Resposta Explicados:

Passo 5: Monitorar Sua Chamada

Verificar Status da Chamada no Painel

Fluxo de Status da Chamada

Passo 6: Testar Diferentes Cenários

Testar com Diferentes Números de Telefone

Testar Tratamento de Erros

Solução de Problemas

Problemas Comuns

Dicas de Depuração

Próximos Passos

​Faça Sua Primeira Chamada

​Pré-requisitos

​Passo 1: Obter Seu ID do Agente

​Do Painel:

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

​Endpoints da API

​Chamada Individual do Agente

​Chamada de Campanha

​Cabeçalhos da Solicitação

​Corpo da Solicitação

​Para Chamadas de Agente

​Para Chamadas de Campanha

​Passo 3: Fazer a Chamada

​Usando cURL

​Usando JavaScript

​Usando Python

​Passo 4: Entender a Resposta

​Campos da Resposta Explicados:

​Passo 5: Monitorar Sua Chamada

​Verificar Status da Chamada no Painel

​Fluxo de Status da Chamada

​Passo 6: Testar Diferentes Cenários

​Testar com Diferentes Números de Telefone

​Testar Tratamento de Erros

​Solução de Problemas

​Problemas Comuns

​Dicas de Depuração

​Próximos Passos

Faça Sua Primeira Chamada

Pré-requisitos

Passo 1: Obter Seu ID do Agente

Do Painel:

Passo 2: Preparar Sua Solicitação da API

Endpoints da API

Chamada Individual do Agente

Chamada de Campanha

Cabeçalhos da Solicitação

Corpo da Solicitação

Para Chamadas de Agente

Para Chamadas de Campanha

Passo 3: Fazer a Chamada

Usando cURL

Usando JavaScript

Usando Python

Passo 4: Entender a Resposta

Campos da Resposta Explicados:

Passo 5: Monitorar Sua Chamada

Verificar Status da Chamada no Painel

Fluxo de Status da Chamada

Passo 6: Testar Diferentes Cenários

Testar com Diferentes Números de Telefone

Testar Tratamento de Erros

Solução de Problemas

Problemas Comuns

Dicas de Depuração

Próximos Passos