Pular para o conteúdo principal
GET
/
v1
/
channels
/
{channelId}
/
webhooks
/
{webhookId}
Buscar webhook
curl --request GET \
  --url https://api.hubmessage.io/v1/channels/{channelId}/webhooks/{webhookId} \
  --header 'Authorization: Bearer <token>'
{
  "id": "A1B2C3D4E5F6789012345678901234AB",
  "instanceId": "019E4C54B1B375A28970B605CA9B03C3",
  "url": "https://app.suaempresa.com/webhooks/hubmessage",
  "description": "Webhook principal de produção",
  "events": [
    "MESSAGE_RECEIVED",
    "MESSAGE_STATUS"
  ],
  "status": "ENABLED",
  "signing": true,
  "auth": {
    "type": "BEARER",
    "configured": true
  },
  "payloadFormat": "DEFAULT",
  "customAttributes": {},
  "createdAt": "2025-01-15T10:30:00.000+0000",
  "updatedAt": "2025-01-15T10:30:00.000+0000"
}

​
Conceituação

Retorna os dados de um webhook específico. Assim como na listagem, as credenciais de autenticação e o secret de assinatura não são retornados por segurança.
Este endpoint requer a role ENTERPRISE na sua conta.
O webhookId é obtido no retorno do endpoint Criar webhook ou Listar webhooks.

Autorizações

​
Authorization
string
header
obrigatório

Secret Key gerada no painel de Segurança do Hub Message

Parâmetros de caminho

​
channelId
string
obrigatório

ID do canal

Exemplo:

"019E4C54B1B375A28970B605CA9B03C3"

​
webhookId
string
obrigatório

ID do webhook

Exemplo:

"A1B2C3D4E5F6789012345678901234AB"

Resposta

Dados do webhook

​
id
string

ID único do webhook

Exemplo:

"A1B2C3D4E5F6789012345678901234AB"

​
instanceId
string

ID do canal ao qual o webhook pertence

Exemplo:

"019E4C54B1B375A28970B605CA9B03C3"

​
url
string

URL de destino dos eventos

Exemplo:

"https://app.suaempresa.com/webhooks/hubmessage"

​
description
string | null

Descrição do webhook

Exemplo:

"Webhook principal de produção"

​
events
string[]

Tipos de evento configurados

Exemplo:
["MESSAGE_RECEIVED", "MESSAGE_STATUS"]
​
status
enum<string>

Status atual do webhook

Opções disponíveis:
ENABLED,
DISABLED
Exemplo:

"ENABLED"

​
signing
boolean

Indica se a assinatura HMAC está habilitada

Exemplo:

true

​
auth
object

Resumo da autenticação configurada — credenciais não são retornadas por segurança

​
payloadFormat
enum<string>

Formato do payload entregue

Opções disponíveis:
DEFAULT,
Z_API
Exemplo:

"DEFAULT"

​
customAttributes
object

Atributos extras configurados

Exemplo:
{}
​
createdAt
string<date-time>

Data de criação

Exemplo:

"2025-01-15T10:30:00.000+0000"

​
updatedAt
string<date-time>

Data da última atualização

Exemplo:

"2025-01-15T10:30:00.000+0000"