Integre o assistente de IA Clawdbot com serviços externos usando webhooks. Aprenda a receber e enviar eventos webhook para automação.

Visão geral dos Webhooks do Clawdbot

O Clawdbot suporta webhooks para integração com serviços externos. Os webhooks permitem automação orientada a eventos, gatilhos externos e comunicação entre serviços.

Webhooks de entrada

Configuração

{
  "webhooks": {
    "incoming": {
      "enabled": true,
      "port": 3011,
      "secret": "your-webhook-secret"
    }
  }
}

Endpoint

POST http://localhost:3011/webhook/<hook-id>

Autenticação

curl -X POST http://localhost:3011/webhook/my-hook \
  -H "X-Webhook-Secret: your-webhook-secret" \
  -H "Content-Type: application/json" \
  -d '{"message": "Hello from external service"}'

Manipuladores de Webhook

Definir um manipulador

{
  "webhooks": {
    "handlers": [
      {
        "id": "github-events",
        "path": "/github",
        "action": "run_agent",
        "agentId": "devops",
        "template": "New GitHub event: {{event.action}} on {{event.repository.name}}"
      }
    ]
  }
}

Ações do manipulador

Ação	Descrição
`send_message`	Enviar mensagem para o canal
`run_agent`	Acionar agente com prompt
`forward`	Encaminhar para outro endpoint
`custom`	Função de manipulador personalizada

Gerenciamento de sessões

Chaves de sessão do Webhook

Os webhooks usam sessões dedicadas:

hook:<uuid>

Opções de sessão

{
  "webhooks": {
    "handlers": [
      {
        "id": "alerts",
        "sessionMode": "persistent",
        "sessionKey": "alerts-session"
      }
    ]
  }
}

Webhooks de saída

Configuração

{
  "webhooks": {
    "outgoing": [
      {
        "id": "slack-notify",
        "url": "https://hooks.slack.com/services/xxx",
        "events": ["message_received", "agent_response"],
        "method": "POST"
      }
    ]
  }
}

Tipos de eventos

Evento	Descrição
`message_received`	Nova mensagem recebida
`agent_response`	Agente gerou uma resposta
`session_started`	Nova sessão criada
`session_ended`	Sessão expirada/encerrada
`error`	Ocorreu um erro

Formato de payload

Payload de entrada

{
  "event": "custom_event",
  "data": {
    "key": "value"
  },
  "timestamp": "2024-01-15T10:30:00Z"
}

Payload de saída

{
  "type": "message_received",
  "session": "agent:main:whatsapp",
  "message": {
    "from": "+15551234567",
    "text": "Hello",
    "timestamp": "2024-01-15T10:30:00Z"
  }
}

Segurança

Verificação de segredo

{
  "webhooks": {
    "incoming": {
      "secretHeader": "X-Webhook-Secret",
      "secret": "your-secret"
    }
  }
}

Lista de IPs permitidos

{
  "webhooks": {
    "incoming": {
      "allowedIPs": [
        "192.168.1.0/24",
        "10.0.0.1"
      ]
    }
  }
}

Tratamento de erros

Configuração de retry

{
  "webhooks": {
    "outgoing": [
      {
        "id": "notify",
        "retry": {
          "maxAttempts": 3,
          "backoff": "exponential"
        }
      }
    ]
  }
}

Tratamento de falhas

Webhooks com falha são registrados
Retry com backoff exponencial
Fila de mensagens mortas opcional

Exemplos

Integração com GitHub

{
  "webhooks": {
    "handlers": [
      {
        "id": "github",
        "path": "/github",
        "action": "send_message",
        "target": {
          "channel": "discord",
          "peer": "dev-channel"
        },
        "template": "🔔 {{event.action}}: {{event.pull_request.title}}"
      }
    ]
  }
}

Encaminhamento de alertas

{
  "webhooks": {
    "handlers": [
      {
        "id": "alerts",
        "path": "/alerts",
        "action": "run_agent",
        "agentId": "oncall",
        "template": "Alert: {{alert.name}} - {{alert.message}}"
      }
    ]
  }
}

Próximos passos

Tarefas Cron do Clawdbot - Tarefas agendadas
Gateway do Clawdbot - Configuração do gateway
Ferramentas do Clawdbot - Configuração de ferramentas

Webhooks do Clawdbot

On this page