Pular para o conteúdo principal

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

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:

​
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
  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)
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: +1234567890

​
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": "+1234567890"
}

​
Para Chamadas de Campanha

{
  "to": "+1234567890",
  "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": "+1234567890"
  }'

​
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: '+1234567890'
    })
  });
  
  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": "+1234567890"
    }
    
    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": "+1234567890",
  "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: 
# 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

ProblemaSolução
401 UnauthorizedVerifique se seu token de ambiente está correto
404 Not FoundVerifique se seu ID do agente está correto
400 Bad RequestVerifique o formato do número de telefone (deve ser +1234567890)
Chamada não tocandoVerifique 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:
🎉 Você fez sua primeira chamada com o Talkover com sucesso! Seu agente de voz com IA agora está pronto para lidar com conversas.