​

Autenticação

​

Obtendo Seu Token de Ambiente

​

Passo 1: Acessar Seu Painel

1. Faça login na sua conta Talkover em app.talkover.ai
2. Navegue até Conta na barra lateral esquerda
3. Clique em “Ambientes”

​

Passo 2: Copiar Seu Token

​

Usando Seu Token em Solicitações da API

​

Cabeçalhos HTTP

Authorization: Bearer talq_seu_token_de_ambiente_aqui

​

Exemplo de Solicitação cURL

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

​

Exemplo de Solicitação JavaScript

const response = await fetch('https://app.talkover.ai/api/v1/agents/agent_123456/call', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer talq_seu_token_de_ambiente_aqui',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    to: '+5511987654321'
  })
});

​

Exemplo de Solicitação Python

import requests

headers = {
    'Authorization': 'Bearer talq_seu_token_de_ambiente_aqui',
    'Content-Type': 'application/json'
}

data = {
    'to': '+5511987654321'
}

response = requests.post(
    'https://app.talkover.ai/api/v1/agents/agent_123456/call',
    headers=headers,
    json=data
)

​

Variáveis de Ambiente

​

Bash/Linux/macOS

export TALKOVER_TOKEN="talq_seu_token_de_ambiente_aqui"

​

Windows (Prompt de Comando)

set TALKOVER_TOKEN=talq_seu_token_de_ambiente_aqui

​

Windows (PowerShell)

$env:TALKOVER_TOKEN="talq_seu_token_de_ambiente_aqui"

​

Usando Variáveis de Ambiente no Código

// JavaScript
const token = process.env.TALKOVER_TOKEN;

# Python
import os
token = os.environ.get('TALKOVER_TOKEN')

// PHP
$token = $_ENV['TALKOVER_TOKEN'];

​

Melhores Práticas de Segurança do Token

​

Faça

• Armazene tokens em variáveis de ambiente
• Use serviços seguros de gerenciamento de segredos
• Rotacione tokens regularmente
• Use tokens diferentes para ambientes diferentes (dev, staging, prod)

​

Não faça

• Nunca cometa tokens no controle de versão
• Não compartilhe tokens em repositórios públicos
• Evite codificar tokens diretamente em sua aplicação
• Não inclua tokens no código do lado do cliente

​

Gerenciamento de Token

​

Regenerando Seu Token

1. Vá para Conta → Ambientes no seu painel
2. Clique em “Regenerar Token”
3. Copie o novo token
4. Atualize suas aplicações com o novo token
5. Delete o token antigo do seu código

​

Expiração do Token

​

Solução de Problemas

​

Erros Comuns de Autenticação

​

Testando Seu Token

curl -H "Authorization: Bearer talq_seu_token_de_ambiente_aqui" \
  https://app.talkover.ai/api/v1/health

​

Próximos Passos

• Aprenda sobre agentes de voz em nosso Guia de Configuração do Agente de Voz
• Faça sua primeira chamada em nosso Tutorial da Primeira Chamada
• Explore nossa referência da API para documentação detalhada de endpoints