Pular para o conteúdo principal
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"
  }'

{
  "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

​
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

​
type
string
obrigatório
Tipo da regra. Opções: recurring, exception.

​
Quando type: "recurring"

​
days_of_week
array
obrigatório
Array de números de dias da semana (1=Seg . 7=Dom).
​
start_time
string
obrigatório
Início da janela. Formato: HH:MM.
​
end_time
string
obrigatório
Fim da janela. Formato: HH:MM.
​
timezone
string
IANA timezone. Padrão é o fuso horário do calendário.

​
Quando type: "exception"

​
date
string
obrigatório
Data da exceção. Formato: YYYY-MM-DD.
​
available
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"
  }'

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