Criação de webhook

Para receber notificações sobre sinais de qualidade e alterações nas configurações da sua conta do WhatsApp Business, é possível configurar um ou mais webhooks.

    Para cadastrar um webhook cadastrado, basta enviar uma requisição `POST` para o endpoint `api/Webhooks/`:

Exemplo de cadastro de webhook:

curl --request POST \
  --url https://api-cerberus-kong.socialminer.tech/api/Webhooks/ \
  --header 'Content-Type: application/json' \
  --header 'apikey: {APIKEY}' \
  --header 'version: 4.0' \
  --data '{
	"phone": "5511964557557",
	"types": ["messages"], 
	"headers": {
		"additionalProp1": "5511964557557",
		"additionalProp2": "teste123",
		"additionalProp3": "string"
	},
	"endpoint": "https://webhook.site/1d2befb1-c201-41e9-be6d-53677ca53bc7"
}'

Caso o cadastro ocorraccom sucesso, será retornado o seguinte json com o http status 201:

{
	"success": true,
	"id": "f2056e5f-46b5-4d91-9a9a-54bb37a436c6",
	"phone": "123606713995007",
	"phone_id": "123606713995007",
	"types": ["messages"], 
	"endpoint": "https://webhook.site/1d2befb1-c201-41e9-be6d-53677ca53bc7",
	"create_date": "2023-03-28T13:24:30.9612293+00:00",
	"update_date": "2023-03-28T13:24:30.9612306+00:00",
	"headers": {
		"additionalProp1": "5511964557557",
		"additionalProp2": "teste123",
		"additionalProp3": "string"
	}
}

É possível configurar um header customizado no seu webhook, além de múltiplos webhooks por usuário de apikey, permitindo separar os pontos de extremidado pelos types, por exemplo.

Atenção:será necessário criar um ponto de extremidade no seu servidor para receber notificações.

Seu servidor deve ter um certificado de TLS ou SSL válido configurado e instalado corretamente. Os certificados autoassinados não são compatíveis.

Campos de assinatura disponíveis

Atualmente somente o webhook messages está disponível.

Campos de assinatura

Nome do campoDescrição
account_review_updateUma notificação é enviada quando a análise de uma conta do WhatsApp Business é concluída.
account_updateUma notificação é enviada quando uma alteração é implementada na sua conta do WhatsApp Business. Essa alteração pode incluir uma atualização do número de telefone, umaviolação das políticas, o banimento de uma conta do WhatsApp Business, entre outros.
business_capability_updateUma notificação é enviada quando um recurso é atualizado. Isso pode incluir uma alteração no número máximo de telefones que uma WABA pode ter ou o número de conversas por telefone.
message_template_status_updateUma notificação é enviada quando o modelo de mensagem é aprovado, rejeitado ou desativado.
messagesUma notificação é enviada quando a sua empresa recebe uma mensagem de um cliente, quando você envia uma mensagem a um cliente, quando a mensagem é entregue ao cliente e quando a mensagem é lida.
phone_number_name_updateUma notificação é enviada quando o nome associado a um número de telefone é aprovado ou rejeitado.
phone_number_quality_updateUma notificação é enviada quando há uma atualização do status de qualidade de um número de telefone.
securityVocê receberá uma notificação nos seguintes casos: -Ao solicitar a desativação do código de confirmação em duas etapas- Quando o código de confirmação em duas etapas é desativado - Quando o código de confirmação em duas etapas é atualizado
Language
Click Try It! to start a request and see the response here!