curl --request PATCH \
--url https://api.hubmessage.io/v1/channels/{channelId}/webhooks/{webhookId} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"status": "DISABLED"
}
'
{
"id": "A1B2C3D4E5F6789012345678901234AB",
"channelId": "019E4C54B1B375A28970B605CA9B03C3",
"instanceId": "019E4C54B1B375A28970B605CA9B03C3",
"url": "https://app.suaempresa.com/webhooks/hubmessage",
"description": "Webhook principal de produção",
"events": [
"MESSAGE_RECEIVED",
"MESSAGE_STATUS"
],
"status": "ENABLED",
"signing": true,
"secret": "d4e5f6789012345678901234abcdef0123456789abcdef0123456789ab12c3d4",
"auth": {
"type": "BEARER",
"configured": true
},
"payloadFormat": "DEFAULT",
"customAttributes": {},
"createdAt": "2025-01-15T10:30:00.000+0000",
"updatedAt": "2025-01-20T14:00:00.000+0000"
}
Canais
Atualizar webhook
Atualize a configuração de um webhook existente
PATCH
/
v1
/
channels
/
{channelId}
/
webhooks
/
{webhookId}
curl --request PATCH \
--url https://api.hubmessage.io/v1/channels/{channelId}/webhooks/{webhookId} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"status": "DISABLED"
}
'
{
"id": "A1B2C3D4E5F6789012345678901234AB",
"channelId": "019E4C54B1B375A28970B605CA9B03C3",
"instanceId": "019E4C54B1B375A28970B605CA9B03C3",
"url": "https://app.suaempresa.com/webhooks/hubmessage",
"description": "Webhook principal de produção",
"events": [
"MESSAGE_RECEIVED",
"MESSAGE_STATUS"
],
"status": "ENABLED",
"signing": true,
"secret": "d4e5f6789012345678901234abcdef0123456789abcdef0123456789ab12c3d4",
"auth": {
"type": "BEARER",
"configured": true
},
"payloadFormat": "DEFAULT",
"customAttributes": {},
"createdAt": "2025-01-15T10:30:00.000+0000",
"updatedAt": "2025-01-20T14:00:00.000+0000"
}
Conceituação
Atualiza parcialmente a configuração de um webhook. Apenas os campos enviados no body são atualizados — os demais permanecem inalterados.Atualizar eventos
Ao enviar o campoevents, a lista substitui todos os eventos existentes:
{ "events": ["MESSAGE_RECEIVED", "MESSAGE_STATUS", "CONNECTED"] }
Habilitar ou rotacionar a assinatura HMAC
Se você enviarsigning: true, um novo secret é gerado e retornado nesta resposta. Use isso também para rotacionar o secret sem precisar recriar o webhook.
{ "signing": true }
O novo
secret é retornado apenas nesta resposta. Armazene-o antes de sair da página ou fechar a sessão.Desabilitar temporariamente
{ "status": "DISABLED" }
DISABLED. Para reativar:
{ "status": "ENABLED" }
Este endpoint requer a role ENTERPRISE na sua conta.
O
webhookId é obtido no retorno do endpoint Criar webhook ou Listar webhooks.Autorizações
Parâmetros de caminho
Corpo
application/json
Todos os campos são opcionais — apenas os campos enviados são atualizados.
Resposta
Webhook atualizado com sucesso. O campo secret é retornado apenas quando signing foi habilitado nesta atualização.