Criar
Quem tem a permissão Gerenciar webhooks cria em Configurações do canal > Webhooks (ou em Configurações do servidor > Integrações). A URL aparece uma vez; dá para gerar outra, o que invalida a antiga. Bots criam com POST /api/v1/channels/{channelId}/webhooks.
Executar
curl -X POST "https://falafy.com.br/api/v1/webhooks/WEBHOOK_ID/TOKEN?wait=true" \
-H "content-type: application/json" \
-d '{"username":"CI","content":"Deploy feito","embeds":[{"title":"Build #42","color":3108715,"fields":[{"name":"branch","value":"main","inline":true}]}]}'
content(até 2000 caracteres) e/ouembeds(até 10).usernameeavatarUrl(https) trocam o nome e o avatar só daquela mensagem. Nomes que se passam pelo Falafy são recusados.?wait=truedevolve a mensagem criada (para editar depois); sem ele, a resposta é 204.- As mensagens aparecem com o selo APP e nunca mencionam ninguém.
Editar e apagar
Com a mesma URL: PATCH e DELETE /api/v1/webhooks/{id}/{token}/messages/{messageId} (só mensagens daquele webhook). GET, PATCH (nome) e DELETE em /api/v1/webhooks/{id}/{token} consultam, renomeiam ou apagam o webhook.
Limites
Até 10 webhooks por canal e um balde de 10 pedidos a cada 2 segundos por webhook. Um webhook apagado responde 404: pare de chamá-lo.