Miscellaneous API Routes
Routes menores: notifications, orders, quick-replies, stats, tags, chatbot.
GET /api/notifications
Seção intitulada “GET /api/notifications”Descrição: Lista as últimas 50 notificações da conta. Inclui contagem de não-lidas. Auth: Required
Response:
- 200:
{ notifications: Notification[], unread_count: number }
PATCH /api/notifications
Seção intitulada “PATCH /api/notifications”Descrição: Marca notificações específicas como lidas (por IDs).
Request:
- Body:
{ ids: ["uuid", "uuid"] }
Response:
- 200:
{ updated: number }
PUT /api/notifications/[id]/read
Seção intitulada “PUT /api/notifications/[id]/read”Descrição: Marca uma notificação específica como lida.
Response:
- 200:
{ updated: true }
PUT /api/notifications/read-all
Seção intitulada “PUT /api/notifications/read-all”Descrição: Marca todas as notificações não-lidas do usuário como lidas.
Response:
- 200:
{ updated: true }
GET /api/orders
Seção intitulada “GET /api/orders”Descrição: Lista pedidos de e-commerce com suporte a filtros e paginação offset-based. Auth: Required
Request:
- Query params:
page,limit,sort,order,platform,financial_status,from,to
Response:
- 200:
{ data: EcommerceOrder[], total, page, limit }
GET /api/quick-replies
Seção intitulada “GET /api/quick-replies”Descrição: Lista todas as respostas rapidas da conta. Auth: Required Rate Limit: Custom - 30 req/60s
Response:
- 200:
QuickReply[](ordenadas portitleascendente)
POST /api/quick-replies
Seção intitulada “POST /api/quick-replies”Descrição: Cria uma nova resposta rapida.
Request:
- Body:
{ title: string, content: string, shortcut?: string, category?: string }
Response:
- 201:
QuickReply
PUT /api/quick-replies/[id]
Seção intitulada “PUT /api/quick-replies/[id]”Descrição: Atualiza uma resposta rapida existente.
Response:
- 200:
QuickReply(atualizada) - 404: Não encontrada
DELETE /api/quick-replies/[id]
Seção intitulada “DELETE /api/quick-replies/[id]”Descrição: Exclui uma resposta rapida permanentemente (hard delete).
Response:
- 204: No content
GET /api/stats/overview
Seção intitulada “GET /api/stats/overview”Descrição: Retorna overview estatistico com KPIs principais, variação semanal, e conversas recentes. Auth: Required
Response:
- 200:
{ totalContacts, activeConversations, messagesToday, totalCampaigns, *Change, recentConversations }
GET /api/stats/charts
Seção intitulada “GET /api/stats/charts”Descrição: Retorna dados para gráficos: mensagens por dia, campanhas recentes e conversas por status. Auth: Required
Request:
- Query params:
period(“7d” | “30d” | “90d”, default “7d”)
Response:
- 200:
{ messages_by_day, campaigns_recent, conversations_by_status }
GET /api/tags
Seção intitulada “GET /api/tags”Descrição: Lista todas as tags da conta (limite 100, ordenadas por nome). Auth: Required
Response:
- 200:
Tag[]
POST /api/tags
Seção intitulada “POST /api/tags”Descrição: Cria uma nova tag.
Request:
- Body:
{ name: string, color: string (#RRGGBB) }
Response:
- 201:
Tag