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
  }
}

​
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.