Novidade: o Kwamle AI Studio já está disponível — crie chatbots inteligentes em minutos.Descobrir →
Recursos

REST API.

Uma API REST moderna para tudo na Kwamle Media — bots, subscritores, publicações, lojas e IA.

REST API.

URL base

https://app.kwamlemedia.com/api/v1

Autenticação

Cada pedido requer um Bearer Token no cabeçalho:

Authorization: Bearer YOUR_API_TOKEN

Obtém o teu token em Definições → Chaves API.

Bots

GET/bots
Lista todos os teus bots.
GET/bots/{id}
Detalhes de um bot específico.
POST/bots
Cria um novo bot.
PATCH/bots/{id}
Atualiza os dados de um bot.
DELETE/bots/{id}
Elimina um bot.

Subscritores

GET/subscribers
Lista os subscritores com paginação.
GET/subscribers/{id}
Dados de um subscritor específico.
POST/subscribers/{id}/messages
Envia uma mensagem a um subscritor específico.
POST/subscribers/{id}/tags
Adiciona uma etiqueta a um subscritor.

Publicações

GET/posts
Lista as publicações agendadas e publicadas.
POST/posts
Cria/agenda uma nova publicação.

Ecommerce

GET/products
Lista os produtos.
POST/products
Adiciona um novo produto.
GET/orders
Lista as encomendas.

AI Studio

POST/ai/chat
Chamada de IA multifornecedor com seleção automática.
GET/ai/usage
Estatísticas de consumo diário de tokens.

Pedido de exemplo

curl -X POST https://app.kwamlemedia.com/api/v1/ai/chat \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [
      {"role": "user", "content": "Write me an ad for a new product"}
    ],
    "max_tokens": 500
  }'

Webhooks

Subscreve eventos em direto da plataforma (nova mensagem, nova encomenda, novo comentário):

POST /webhooks
{
  "url": "https://yourdomain.com/webhook",
  "events": ["message.received", "order.created", "comment.posted"]
}

Limite de taxa

  • Free: 60 pedidos/min
  • Pro: 600 pedidos/min
  • Enterprise: 6.000 pedidos/min + personalizado

Os cabeçalhos X-RateLimit-Remaining e X-RateLimit-Reset devolvem informação em tempo real.

SDKs oficiais em desenvolvimento

Brevemente: bibliotecas para Node.js, Python, PHP e Go.
Para questões técnicas: api@kwamlemedia.com