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
}
}
Conexões com Provedores
Criar Conexão com Provedor
Conectar um calendário a um provedor externo
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
string
obrigatório
UUID do calendário.
Cabeçalhos da requisição
string
obrigatório
Token Bearer para autenticação. Formato:
Bearer talq_your_environment_token_herestring
obrigatório
Deve ser
application/json.Corpo da requisição
string
obrigatório
Identificador do provedor (retornado pela configuração do seu ambiente).
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.
Esta página foi útil?