Webhooks

Webhooks permitem que sua aplicação receba notificações em tempo real quando eventos acontecem no seu workspace Spaace. Configure endpoints para receber payloads HTTP automaticamente.

Como funciona

Quando um evento ocorre (ex.: nova mensagem, workflow completado), o Spaace envia um POST request para a URL que você configurou com os dados do evento em JSON.

Eventos disponíveis

Evento	Descrição
message.created	Nova mensagem enviada no chat
workflow.completed	Um workflow terminou de executar
universe.updated	O grafo de conhecimento foi atualizado
member.joined	Novo membro entrou no workspace

Payload exemplo

JSON

{
  "id": "evt_xyz789",
  "type": "message.created",
  "created_at": "2025-08-20T14:30:00Z",
  "data": {
    "message_id": "msg_abc123",
    "workspace_id": "ws_abc123",
    "content": "Olá!",
    "sender": "user_456"
  }
}

Verificação de assinatura

Toda requisição de webhook inclui um header X-Spaace-Signature com um HMAC SHA-256 do body usando seu webhook secret. Sempre verifique a assinatura antes de processar o evento.