Passar para o conteúdo principal

Como rastrear atualizações de modelos usando webhooks da Wati

Resumo

A Wati fornece eventos de webhook que ajudam você a monitorar atualizações relacionadas aos modelos de mensagem do WhatsApp em tempo real. Esses eventos de webhook permitem rastrear alterações no status de revisão do modelo, atualizações de classificação de qualidade e atualizações de categoria diretamente de seus sistemas.

Você pode usar esses webhooks para automatizar fluxos de trabalho, monitorar a saúde dos modelos, notificar administradores sobre alterações importantes e manter seus sistemas internos sincronizados com as últimas atualizações de modelos.

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

Instruções

1. Atualização do status do modelo

  • Disparado quando: O status de revisão de um modelo do WhatsApp muda

  • Evento: templateReviewed

  • Status: Status do modelo atualizado

Exemplo de carga útil do webhook

{
"eventType": "templateReviewed",
"wabaId": "1111111",
"templateName": "qweqw",
"templateId": "1982737699205572",
"watiTemplateId": "68aeb8ca3463af036eff5dba",
"oldTemplateStatus": 1,
"newTemplateStatus": 2,
"channelId": null,
"channelPhoneNumber": "17735704742"
}

Códigos de status do modelo

Código de status

Status

0

Rascunho

1

Pendente

2

Aprovado

3

Rejeitado

4

Excluído

5

Pendente Interno

6

Desativado

7

Pausado

Casos de uso

  • Rastrear atualizações de aprovação e rejeição de modelos automaticamente

  • Notificar administradores quando modelos forem rejeitados ou pausados

  • Sincronizar alterações de status de modelos com sistemas externos

  • Criar dashboards para monitoramento e relatórios de modelos

  • Disparar fluxos de trabalho quando modelos forem aprovados ou desativados

2. Atualização da qualidade do modelo

  • Disparado quando: A classificação de qualidade de um modelo do WhatsApp muda

  • Evento: templateQualityUpdated

  • Status: Qualidade do modelo atualizada

Exemplo de carga útil do webhook

{
"eventType": "templateQualityUpdated",
"templateId": "1405047553933887",
"wabaId": "1111111",
"templateName": "qweqw",
"watiTemplateId": "68aea8bf4b1585cba9ad8a6c",
"oldTemplateQuality": 0,
"newTemplateQuality": 1,
"channelId": null,
"channelPhoneNumber": "17735704742"
}

Códigos de classificação de qualidade do modelo

Código de qualidade

Classificação de qualidade

0

Desconhecido - indica qualidade pendente

1

Verde - indica alta qualidade

2

Vermelho - indica baixa qualidade

3

Amarelo - indica qualidade média

Casos de uso

  • Monitorar alterações na qualidade do modelo automaticamente

  • Alertar administradores quando a qualidade do modelo cair para amarelo ou vermelho

  • Rastrear a saúde dos modelos em vários números do WhatsApp

  • Criar dashboards internos para monitoramento da qualidade dos modelos

  • Disparar revisões ou atualizações para modelos com baixo desempenho

3. Atualização da categoria do modelo

  • Disparado quando: A categoria de um modelo do WhatsApp muda

  • Evento: templateCategoryUpdated

  • Status: Categoria do modelo atualizada

Exemplo de carga útil do webhook

{
"eventType": "templateCategoryUpdated",
"templateId": "3355991204552950",
"wabaId": "1111111",
"templateName": "qweqw",
"watiTemplateId": "68aea8bf4b1585cba9ad8a6a",
"oldTemplateCategory": "UTILITY",
"newTemplateCategory": "MARKETING",
"channelId": null,
"channelPhoneNumber": "17735704742"
}

Categorias de modelos suportadas

  • MARKETING

  • UTILITY

  • AUTHENTICATION

Casos de uso

  • Monitorar alterações na categoria do modelo automaticamente

  • Sincronizar categorias de modelos com sistemas externos

  • Notificar administradores quando a categoria de um modelo mudar

  • Validar o uso de modelos contra políticas internas

  • Criar dashboards de relatórios para categorização de modelos

Melhores práticas

  • Armazene identificadores como templateId e watiTemplateId para rastreamento

  • Monitore a qualidade do modelo regularmente para evitar restrições de modelo

  • Use eventos de webhook para automatizar notificações e relatórios

  • Mantenha os sistemas internos sincronizados com as atualizações de modelos da Wati e da Meta

Perguntas Frequentes (FAQs)

Visão geral geral

1. O que os webhooks de atualização de modelo na Wati ajudam a rastrear?

Os webhooks de atualização de modelo na Wati ajudam a rastrear alterações no status de revisão de modelos de mensagem do WhatsApp, atualizações de classificação de qualidade e atualizações de categoria em tempo real.

2. Por que as empresas devem usar webhooks de atualização de modelo?

As empresas podem usar webhooks de atualização de modelo para automatizar fluxos de trabalho, monitorar a saúde dos modelos, notificar administradores sobre alterações importantes e manter sistemas internos sincronizados com as últimas atualizações de modelos.

Webhook de atualização de status do modelo

3. Quando o evento de webhook templateReviewed é acionado?

O evento de webhook templateReviewed é acionado quando o status de revisão de um modelo do WhatsApp muda.

4. Quais status de modelo são suportados no webhook de Atualização de Status do Modelo?

O webhook de Atualização de Status do Modelo suporta os seguintes status:

  • 0 — Rascunho

  • 1 — Pendente

  • 2 — Aprovado

  • 3 — Rejeitado

  • 4 — Excluído

  • 5 — Pendente Interno

  • 6 — Desativado

  • 7 — Pausado

5. Para que o webhook de Atualização de Status do Modelo pode ser usado?

O webhook de Atualização de Status do Modelo pode ser usado para rastrear atualizações de aprovação e rejeição, notificar administradores sobre modelos pausados ou rejeitados, sincronizar alterações de status com sistemas externos e disparar fluxos de trabalho com base em atualizações de status de modelo.

Webhook de atualização de qualidade do modelo

6. Quando o evento de webhook templateQualityUpdated é acionado?

O evento de webhook templateQualityUpdated é acionado quando a classificação de qualidade de um modelo do WhatsApp muda.

7. Quais classificações de qualidade são suportadas no webhook de Atualização de Qualidade do Modelo?

O webhook de Atualização de Qualidade do Modelo suporta as seguintes classificações de qualidade:

  • 0 — Desconhecido

  • 1 — Verde

  • 2 — Vermelho

  • 3 — Amarelo

8. Para que o webhook de Atualização de Qualidade do Modelo pode ser usado?

O webhook de Atualização de Qualidade do Modelo pode ser usado para monitorar alterações na qualidade do modelo, alertar administradores quando a qualidade do modelo cair, rastrear a saúde do modelo em números do WhatsApp e disparar revisões para modelos com baixo desempenho.

Webhook de atualização de categoria do modelo

9. Quando o evento de webhook templateCategoryUpdated é acionado?

O evento de webhook templateCategoryUpdated é acionado quando a categoria de um modelo do WhatsApp muda.

10. Quais categorias de modelo são suportadas no webhook de Atualização de Categoria do Modelo?

O webhook de Atualização de Categoria do Modelo suporta as seguintes categorias de modelo:

  • MARKETING

  • UTILITY

  • AUTHENTICATION

Respondeu à sua pergunta?