curl "https://app.talkover.ai/api/v1/calendars/calendar-uuid-1/availability?from=2024-01-15T00:00:00Z&to=2024-01-22T00:00:00Z&duration_minutes=30" \
-H "Authorization: Bearer talq_your_environment_token_here"
{
"success": true,
"data": [
{ "start_at": "2024-01-15T09:00:00Z", "end_at": "2024-01-15T09:30:00Z" },
{ "start_at": "2024-01-15T09:30:00Z", "end_at": "2024-01-15T10:00:00Z" },
{ "start_at": "2024-01-15T10:00:00Z", "end_at": "2024-01-15T10:30:00Z" }
]
}
Disponibilidade
Consultar Disponibilidade
Calcular horários disponíveis de um calendário
GET
/
api
/
v1
/
calendars
/
{calendar_id}
/
availability
curl "https://app.talkover.ai/api/v1/calendars/calendar-uuid-1/availability?from=2024-01-15T00:00:00Z&to=2024-01-22T00:00:00Z&duration_minutes=30" \
-H "Authorization: Bearer talq_your_environment_token_here"
{
"success": true,
"data": [
{ "start_at": "2024-01-15T09:00:00Z", "end_at": "2024-01-15T09:30:00Z" },
{ "start_at": "2024-01-15T09:30:00Z", "end_at": "2024-01-15T10:00:00Z" },
{ "start_at": "2024-01-15T10:00:00Z", "end_at": "2024-01-15T10:30:00Z" }
]
}
Consultar Disponibilidade
Calcular horários disponíveis de um calendário em um intervalo determinado, aplicando regras recorrentes, exceções e eventos existentes como horário ocupado.Endpoint
GET /api/v1/calendars/{calendar_id}/availability
Parâmetros de caminho
string
obrigatório
UUID do calendário.
Parâmetros de consulta
string
obrigatório
Início do intervalo. ISO 8601.
string
obrigatório
Fim do intervalo. ISO 8601.
integer
Duração do horário a calcular. Padrão:
30.Cabeçalhos da requisição
string
obrigatório
Token Bearer para autenticação. Formato:
Bearer talq_your_environment_token_hereExemplos
curl "https://app.talkover.ai/api/v1/calendars/calendar-uuid-1/availability?from=2024-01-15T00:00:00Z&to=2024-01-22T00:00:00Z&duration_minutes=30" \
-H "Authorization: Bearer talq_your_environment_token_here"
Resposta
{
"success": true,
"data": [
{ "start_at": "2024-01-15T09:00:00Z", "end_at": "2024-01-15T09:30:00Z" },
{ "start_at": "2024-01-15T09:30:00Z", "end_at": "2024-01-15T10:00:00Z" },
{ "start_at": "2024-01-15T10:00:00Z", "end_at": "2024-01-15T10:30:00Z" }
]
}
Observações
- Os horários ficam dentro das regras recorrentes e excluem eventos ocupados e datas de exceção.
- Use este endpoint para alimentar agentes de agendamento — deixe que o agente ofereça esses horários ao interlocutor.
Esta página foi útil?