falafy
PT
Baixar grátis

API pública v1 · @falafy/bot

Webhooks de entrada

Uma URL secreta por webhook posta mensagens em um canal, sem bot e sem login.

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/ou embeds (até 10).
  • username e avatarUrl (https) trocam o nome e o avatar só daquela mensagem. Nomes que se passam pelo Falafy são recusados.
  • ?wait=true devolve 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.