Cria ou gira o endereço do webhook de entrada
POST/api/workflows/{id}/triggers/{nodeId}/webhook
- Auth
- Requiere token
- Quién puede:
- owner
- admin
- Clave de API:
- No acepta clave de API
- X-CommunityId
X-CommunityIdEnvía el X-CommunityId de la comunidad en la que ocurre la operación.
Las descripciones de los endpoints vienen de la especificación de la API y, por ahora, están en portugués. La interfaz alrededor está traducida.
Só owner e admin. Cria o endereço do gatilho `webhook.received` (ou gira: um token novo na hora, o antigo para de valer) e, com `hmac` (padrão `true`), um segredo de assinatura novo; `hmac: false` tira a assinatura, e então o gatilho só pode levar a passos sem conteúdo (tag e grupo): com e-mail, DM, comentário, reação ou Slack no caminho, ligar o workflow responde 422 `workflows.webhookHmacRequired`. **O token e o segredo aparecem só nesta resposta.** Use o cabeçalho `X-Memberfy-Hook-Token` com `url` (recomendado) ou `urlWithToken`. Cada criação e giro entra na auditoria.
Parámetros
| Nombre | Dónde | Tipo | Descripción |
|---|---|---|---|
idobligatorio | path | string (uuid) | |
nodeIdobligatorio | path | string |
Headers
| Nombre | Tipo | Descripción |
|---|---|---|
X-CommunityIdopcional | string (uuid) | ID da comunidade em que a operação acontece. Obrigatório na maioria dos endpoints com escopo de comunidade. |
Cuerpo de la solicitud application/json
| Nombre | Tipo | Descripción |
|---|---|---|
hmacopcional | boolean |
Respuestas
| Código | Descripción |
|---|---|
200 | O endereço com o token e o segredo (uma vez). |
403 | Autenticado, mas sem permissão para esta operação. |
404 | Workflow ou gatilho de webhook não encontrado. |
Ejemplo con curl
curl -X POST "https://api.memberfy.net/api/workflows/<id>/triggers/<nodeId>/webhook" \
-H "Authorization: Bearer $TOKEN" \
-H "X-CommunityId: $COMMUNITY_ID" \
-H "Content-Type: application/json" \
-d '{}'