# Janela recorrente em dias úteis
curl -X POST "https://app.talkover.ai/api/v1/calendars/calendar-uuid-1/availability-rules" \
-H "Authorization: Bearer talq_your_environment_token_here" \
-H "Content-Type: application/json" \
-d '{
"type": "recurring",
"days_of_week": [1, 2, 3, 4, 5],
"start_time": "09:00",
"end_time": "17:00"
}'
# Exceção de feriado (bloquear 25 de dezembro)
curl -X POST "https://app.talkover.ai/api/v1/calendars/calendar-uuid-1/availability-rules" \
-H "Authorization: Bearer talq_your_environment_token_here" \
-H "Content-Type: application/json" \
-d '{ "type": "exception", "date": "2024-12-25", "available": false }'
{
"success": true,
"data": {
"id": "rule-uuid-1",
"type": "recurring",
"days_of_week": [1, 2, 3, 4, 5],
"start_time": "09:00",
"end_time": "17:00"
}
}
Disponibilidade
Criar Regra de Disponibilidade
Adicionar uma regra de disponibilidade recorrente ou de exceção
POST
/
api
/
v1
/
calendars
/
{calendar_id}
/
availability-rules
# Janela recorrente em dias úteis
curl -X POST "https://app.talkover.ai/api/v1/calendars/calendar-uuid-1/availability-rules" \
-H "Authorization: Bearer talq_your_environment_token_here" \
-H "Content-Type: application/json" \
-d '{
"type": "recurring",
"days_of_week": [1, 2, 3, 4, 5],
"start_time": "09:00",
"end_time": "17:00"
}'
# Exceção de feriado (bloquear 25 de dezembro)
curl -X POST "https://app.talkover.ai/api/v1/calendars/calendar-uuid-1/availability-rules" \
-H "Authorization: Bearer talq_your_environment_token_here" \
-H "Content-Type: application/json" \
-d '{ "type": "exception", "date": "2024-12-25", "available": false }'
{
"success": true,
"data": {
"id": "rule-uuid-1",
"type": "recurring",
"days_of_week": [1, 2, 3, 4, 5],
"start_time": "09:00",
"end_time": "17:00"
}
}
Criar Regra de Disponibilidade
Adicionar uma regra de disponibilidade (janela recorrente ou data de exceção) a um calendário.Endpoint
POST /api/v1/calendars/{calendar_id}/availability-rules
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
Tipo da regra. Opções:
recurring, exception.Quando type: "recurring"
array
obrigatório
Array de números de dias da semana (
1=Seg . 7=Dom).string
obrigatório
Início da janela. Formato:
HH:MM.string
obrigatório
Fim da janela. Formato:
HH:MM.string
IANA timezone. Padrão é o fuso horário do calendário.
Quando type: "exception"
string
obrigatório
Data da exceção. Formato:
YYYY-MM-DD.boolean
obrigatório
Indica se essa data está disponível (sobrescreve regras recorrentes) ou bloqueada.
Exemplos
# Janela recorrente em dias úteis
curl -X POST "https://app.talkover.ai/api/v1/calendars/calendar-uuid-1/availability-rules" \
-H "Authorization: Bearer talq_your_environment_token_here" \
-H "Content-Type: application/json" \
-d '{
"type": "recurring",
"days_of_week": [1, 2, 3, 4, 5],
"start_time": "09:00",
"end_time": "17:00"
}'
# Exceção de feriado (bloquear 25 de dezembro)
curl -X POST "https://app.talkover.ai/api/v1/calendars/calendar-uuid-1/availability-rules" \
-H "Authorization: Bearer talq_your_environment_token_here" \
-H "Content-Type: application/json" \
-d '{ "type": "exception", "date": "2024-12-25", "available": false }'
Resposta
{
"success": true,
"data": {
"id": "rule-uuid-1",
"type": "recurring",
"days_of_week": [1, 2, 3, 4, 5],
"start_time": "09:00",
"end_time": "17:00"
}
}
Esta página foi útil?