Resumo

Este guia explica os eventos de webhook relacionados a Contas do WhatsApp Business (WABA) e números de telefone na Wati. Esses eventos ajudam você a monitorar alterações no status da conta, atualizações de políticas, atualizações de qualidade de número de telefone e eventos de exclusão em tempo real. Você pode usar esses webhooks para automatizar notificações, acionar fluxos de trabalho e manter seus sistemas internos sincronizados com a Wati.

Nota: Para mais informações sobre webhooks da Wati, consulte a documentação do desenvolvedor da Wati.

Instruções

1. Atualização de revisão de status da WABA

Este webhook é acionado quando o status de revisão de uma Conta do WhatsApp Business é alterado.

Acionado quando: O status de revisão de uma Conta do WhatsApp Business (WABA) é alterado
Evento: wabaStatusReviewUpdate
Status: Status de revisão da WABA atualizado

Carga útil de webhook de exemplo

{
  "eventType": "wabaStatusReviewUpdate",
  "accountReviewStatus": "APPROVED",
  "wabaId": "330039560200863"
}

Valores de status de revisão da WABA

Valor do status	Descrição
`APPROVED`	A Conta do WhatsApp Business está aprovada e pronta para uso com APIs.
`REJECTED`	A Conta do WhatsApp Business foi rejeitada devido a violações de política e não pode ser usada com APIs.
`PENDING`	O processo de revisão ainda está pendente e a Conta do WhatsApp Business ainda não pode ser usada com APIs.
`DEFERRED`	A decisão de revisão foi adiada e a Conta do WhatsApp Business atualmente não pode ser usada com APIs.

Casos de uso

Monitorar alterações no status de revisão da Conta do WhatsApp Business automaticamente
Notificar administradores quando uma WABA é aprovada ou rejeitada
Acionar fluxos de trabalho de integração após a aprovação da WABA
Pausar fluxos de trabalho relacionados à API quando uma WABA estiver pendente ou adiada
Manter sistemas internos sincronizados com atualizações de revisão da WABA

2. Conta WABA excluída

Este webhook é acionado quando uma Conta do WhatsApp Business é excluída.

Acionado quando: Uma Conta do WhatsApp Business (WABA) é excluída
Evento: accountDeleted
Status: Conta WABA excluída

Carga útil de webhook de exemplo

{
  "eventType": "accountDeleted",
  "wabaId": "message.WabaId"
}

Casos de uso

Detectar quando uma Conta do WhatsApp Business é removida
Notificar administradores sobre contas WABA excluídas
Remover contas WABA desconectadas de sistemas internos
Acionar fluxos de trabalho de limpeza após a exclusão da conta
Manter registros de conta sincronizados com atualizações da Wati

3. Conta WABA atualizada

Este webhook é acionado quando uma Conta do WhatsApp Business recebe atualizações relacionadas à conta, como violações de política, proibições ou restrições.

Acionado quando: Uma Conta do WhatsApp Business (WABA) recebe uma atualização relacionada à conta, como violações de política, proibições ou restrições
Evento: accountUpdated
Status: Conta WABA atualizada

Carga útil de webhook de exemplo

{
  "eventType": "accountUpdated",
  "wabaId": "message.WabaId",
  "event": "message.Event",
  "violationInfo": {
    "violation_type": "message.ViolationType"
  },
  "banInfo": {
    "waba_ban_state": "message.WabaBanState",
    "waba_ban_date": "message.WabaBanDate"
  },
  "restriction_info": [
    {
      "restriction_type": "RESTRICTED_ADD_PHONE_NUMBER_ACTION",
      "expiration": "2026-04-19T13:59:20+0000"
    },
    {
      "restriction_type": "RESTRICTED_BIZ_INITIATED_MESSAGING",
      "expiration": "2026-04-19T13:59:20+0000"
    },
    {
      "restriction_type": "RESTRICTED_CUSTOMER_INITIATED_MESSAGING",
      "expiration": "2026-04-19T13:59:20+0000"
    }
  ]
}

Tipos de restrição

Tipo de restrição	Descrição
`RESTRICTED_ADD_PHONE_NUMBER_ACTION`	Restringe a adição de novos números de telefone à WABA.
`RESTRICTED_BIZ_INITIATED_MESSAGING`	Restringe mensagens iniciadas pela empresa.
`RESTRICTED_CUSTOMER_INITIATED_MESSAGING`	Restringe mensagens iniciadas pelo cliente.

Casos de uso

Monitorar violações de política em Contas do WhatsApp Business
Detectar proibições ou restrições de conta automaticamente
Notificar administradores sobre problemas de integridade da conta
Acionar fluxos de trabalho quando restrições de mensagens forem aplicadas
Manter sistemas de conformidade e monitoramento sincronizados com atualizações da WABA
Rastrear datas de expiração de restrições para planejamento operacional

4. Evento de atualização de qualidade do número de telefone

Este webhook é acionado quando a qualidade de mensagens, taxa de transferência ou limite de mensagens de um número de telefone do WhatsApp é alterado.

Acionado quando: A qualidade de mensagens, taxa de transferência ou limite de mensagens de um número de telefone do WhatsApp é alterado
Evento: PhoneNumberQualityUpdatedEvent
Status: Qualidade do número de telefone atualizada

Carga útil de webhook de exemplo

{
  "eventType": "PhoneNumberQualityUpdatedEvent",
  "phoneNumber": "12177593225",
  "event": "THROUGHPUT_UPGRADE",
  "currentLimit": "TIER_UNLIMITED",
  "oldLimit": "",
  "channelId": null,
  "channelPhoneNumber": "17735704742"
}

Valores de limite de mensagens e taxa de transferência

Valor	Descrição
`TIER_50`	Limite de mensagens de 50.
`TIER_250`	Limite de mensagens de 250.
`TIER_1K`	Limite de mensagens de 1.000.
`TIER_10K`	Limite de mensagens de 10.000.
`TIER_100K`	Limite de mensagens de 100.000.
`TIER_NOT_SET`	O número de telefone da empresa ainda não foi usado para enviar mensagens.
`TIER_UNLIMITED`	O número de telefone da empresa tem maior taxa de transferência e capacidade ilimitada de mensagens.

Casos de uso

Monitorar alterações no limite de mensagens e taxa de transferência automaticamente
Detectar atualizações ou rebaixamentos na qualidade do número de telefone
Notificar administradores quando a capacidade de mensagens muda
Rastrear atualizações de nível de mensagens em números do WhatsApp
Acionar fluxos de trabalho operacionais com base em alterações de taxa de transferência

5. Número de telefone excluído

Este webhook é acionado quando um número de telefone é removido de uma Conta do WhatsApp Business.

Acionado quando: Um número de telefone é removido de uma Conta do WhatsApp Business (WABA)
Evento: phoneNumberDeleted
Status: Número de telefone excluído

Carga útil de webhook de exemplo

{
  "eventType": "phoneNumberDeleted",
  "wabaId": "message.WabaId",
  "phoneNumber": "message.PhoneNumber"
}

Casos de uso

Detectar quando um número de telefone é removido de uma Conta do WhatsApp Business
Notificar administradores sobre números do WhatsApp excluídos
Remover números de telefone desconectados de sistemas internos
Acionar fluxos de trabalho de limpeza após a exclusão do número de telefone
Manter registros de conta e canal sincronizados com atualizações da Wati

Perguntas Frequentes (FAQs)

Eventos de webhook da WABA

1. Para que servem os eventos de webhook da WABA e de número de telefone na Wati?

Os eventos de webhook da WABA e de número de telefone na Wati são usados para monitorar alterações no status da conta, atualizações de políticas, atualizações de qualidade de número de telefone e eventos de exclusão em tempo real. Esses webhooks podem ajudar a automatizar notificações, acionar fluxos de trabalho e manter sistemas internos sincronizados com a Wati.

2. O que significa o evento de webhook wabaStatusReviewUpdate?

O evento de webhook wabaStatusReviewUpdate é acionado quando o status de revisão de uma Conta do WhatsApp Business (WABA) é alterado.

3. O que significam os valores de status de revisão da WABA?

Os valores de status de revisão da WABA têm os seguintes significados:

APPROVED significa que a Conta do WhatsApp Business está aprovada e pronta para uso com APIs.
REJECTED significa que a Conta do WhatsApp Business foi rejeitada devido a violações de política e não pode ser usada com APIs.
PENDING significa que o processo de revisão ainda está pendente e a Conta do WhatsApp Business ainda não pode ser usada com APIs.
DEFERRED significa que a decisão de revisão foi adiada e a Conta do WhatsApp Business atualmente não pode ser usada com APIs.

4. O que significa o evento de webhook accountDeleted?

O evento de webhook accountDeleted é acionado quando uma Conta do WhatsApp Business (WABA) é excluída.

5. O que significa o evento de webhook accountUpdated?

O evento de webhook accountUpdated é acionado quando uma Conta do WhatsApp Business recebe atualizações relacionadas à conta, como violações de política, proibições ou restrições.

6. Quais tipos de restrição podem ser incluídos no webhook accountUpdated?

O webhook accountUpdated pode incluir os seguintes tipos de restrição:

RESTRICTED_ADD_PHONE_NUMBER_ACTION restringe a adição de novos números de telefone à WABA.
RESTRICTED_BIZ_INITIATED_MESSAGING restringe mensagens iniciadas pela empresa.
RESTRICTED_CUSTOMER_INITIATED_MESSAGING restringe mensagens iniciadas pelo cliente.

7. O que significa o evento de webhook PhoneNumberQualityUpdatedEvent?

O evento de webhook PhoneNumberQualityUpdatedEvent é acionado quando a qualidade de mensagens, taxa de transferência ou limite de mensagens de um número de telefone do WhatsApp é alterado.

8. O que significam os valores de limite de mensagens no webhook PhoneNumberQualityUpdatedEvent?

Os valores de limite de mensagens indicam a capacidade de mensagens de um número de telefone do WhatsApp:

TIER_50 significa um limite de mensagens de 50.
TIER_250 significa um limite de mensagens de 250.
TIER_1K significa um limite de mensagens de 1.000.
TIER_10K significa um limite de mensagens de 10.000.
TIER_100K significa um limite de mensagens de 100.000.
TIER_NOT_SET significa que o número de telefone da empresa ainda não foi usado para enviar mensagens.
TIER_UNLIMITED significa que o número de telefone da empresa tem maior taxa de transferência e capacidade ilimitada de mensagens.

9. O que significa o evento de webhook phoneNumberDeleted?

O evento de webhook phoneNumberDeleted é acionado quando um número de telefone é removido de uma Conta do WhatsApp Business (WABA).

Como usar eventos de webhook de WABA e números de telefone

Resumo

Instruções

1. Atualização de revisão de status da WABA

Carga útil de webhook de exemplo

Valores de status de revisão da WABA

Casos de uso

2. Conta WABA excluída

Carga útil de webhook de exemplo

Casos de uso

3. Conta WABA atualizada

Carga útil de webhook de exemplo

Tipos de restrição

Casos de uso

4. Evento de atualização de qualidade do número de telefone

Carga útil de webhook de exemplo

Valores de limite de mensagens e taxa de transferência

Casos de uso

5. Número de telefone excluído

Carga útil de webhook de exemplo

Casos de uso

Perguntas Frequentes (FAQs)

Eventos de webhook da WABA

1. Para que servem os eventos de webhook da WABA e de número de telefone na Wati?

2. O que significa o evento de webhook wabaStatusReviewUpdate?

3. O que significam os valores de status de revisão da WABA?

4. O que significa o evento de webhook accountDeleted?

5. O que significa o evento de webhook accountUpdated?

6. Quais tipos de restrição podem ser incluídos no webhook accountUpdated?

7. O que significa o evento de webhook PhoneNumberQualityUpdatedEvent?

8. O que significam os valores de limite de mensagens no webhook PhoneNumberQualityUpdatedEvent?

9. O que significa o evento de webhook phoneNumberDeleted?