Pular para o conteúdo principal
POST
/
api
/
v1
/
calendars
/
{calendar_id}
/
providers
curl -X POST "https://app.talkover.ai/api/v1/calendars/calendar-uuid-1/providers" \
  -H "Authorization: Bearer talq_your_environment_token_here" \
  -H "Content-Type: application/json" \
  -d '{
    "provider": "calendar_provider_a",
    "redirect_uri": "https://example.com/oauth/calendar/callback"
  }'
{
  "success": true,
  "data": {
    "id": "conn-uuid-1",
    "provider": "calendar_provider_a",
    "authorization_url": "https://provider.example.com/oauth/authorize?...",
    "is_active": false
  }
}

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.

Criar Conexão com Provedor

Iniciar uma conexão entre um calendário e um provedor de calendário externo. O fluxo OAuth é concluído por meio de uma URL de redirecionamento retornada na resposta.

Endpoint

POST /api/v1/calendars/{calendar_id}/providers

Parâmetros de Caminho

calendar_id
string
obrigatório
UUID do calendário.

Cabeçalhos da Requisição

Authorization
string
obrigatório
Token Bearer para autenticação. Formato: Bearer talq_your_environment_token_here
Content-Type
string
obrigatório
Deve ser application/json.

Corpo da Requisição

provider
string
obrigatório
Identificador do provedor (retornado pela configuração do seu ambiente).
redirect_uri
string
obrigatório
URL para a qual o provedor redirecionará após o usuário autorizar o acesso.

Exemplos

curl -X POST "https://app.talkover.ai/api/v1/calendars/calendar-uuid-1/providers" \
  -H "Authorization: Bearer talq_your_environment_token_here" \
  -H "Content-Type: application/json" \
  -d '{
    "provider": "calendar_provider_a",
    "redirect_uri": "https://example.com/oauth/calendar/callback"
  }'

Resposta

{
  "success": true,
  "data": {
    "id": "conn-uuid-1",
    "provider": "calendar_provider_a",
    "authorization_url": "https://provider.example.com/oauth/authorize?...",
    "is_active": false
  }
}

Observações

  • Após o usuário concluir o fluxo OAuth em authorization_url, a conexão se torna ativa e a primeira sincronização é executada automaticamente.