whatsapp-docs-mcp 1.0.0

package/docs/modelos/gerenciamento_de_modelos/template_management.md

@@ -0,0 +1,148 @@
+<!-- Source: https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/template-management -->
+<!-- Scraped: 2025-12-20T17:33:23.846Z -->
+
+# Gerenciamento de modelos
+
+Updated: 14 de nov de 2025
+
+Conheça os pontos de extremidade comuns usados para gerenciar modelos.
+
+## Obter modelos
+
+Use o ponto de extremidade [`GET/<WHATSAPP_BUSINESS_ACCOUNT_ID>/message_templates`](/documentation/business-messaging/whatsapp/reference/whatsapp-business-account/template-api?#Reading) para obter uma lista de modelos em uma conta do WhatsApp Business.
+
+### Obter todos os modelos
+
+Exemplo de solicitação para obter todos os modelos (campos padrão):
+
+```
+curl 'https://graph.facebook.com/v23.0/102290129340398/message_templates' \-H 'Authorization: Bearer EAAJB...'
+```
+
+Exemplo de resposta truncada (`...`) para fins de concisão:
+
+```
+{  "data": [    {      "name": "reservation_confirmation",      "parameter_format": "NAMED",      "components": [        {          "type": "HEADER",          "format": "IMAGE",          "example": {            "header_handle": [              "https://scontent.whatsapp.net/v/t61..."            ]          }        },        {          "type": "BODY",          "text": "*You're all set!*\n\nYour reservation for {{number_of_guests}} at Lucky Shrub Eatery on {{day}}, {{date}}, at {{time}}, is confirmed. See you then!",          "example": {            "body_text_named_params": [              {                "param_name": "number_of_guests",                "example": "4"              },              {                "param_name": "day",                "example": "Saturday"              },              {                "param_name": "date",                "example": "August 30th, 2025"              },              {                "param_name": "time",                "example": "7:30 pm"              }            ]          }        },        {          "type": "FOOTER",          "text": "Lucky Shrub Eatery: The Luckiest Eatery in Town!"        },        {          "type": "BUTTONS",          "buttons": [            {              "type": "URL",              "text": "Change reservation",              "url": "https://www.luckyshrubeater.com/reservations"            },            {              "type": "PHONE_NUMBER",              "text": "Call us",              "phone_number": "+16467043595"            },            {              "type": "QUICK_REPLY",              "text": "Cancel reservation"            }          ]        }      ],      "language": "en_US",      "status": "APPROVED",      "category": "UTILITY",      "id": "1387372356726668"    },    {      "name": "coupon_expiration_reminder_number_vars",      "parameter_format": "POSITIONAL",      "components": [        {          "type": "HEADER",          "format": "TEXT",          "text": "Act fast, {{1}}!",          "example": {            "header_text": [              "Pablo"            ]          }        },        {          "type": "BODY",          "text": "Just a quick reminder—your exclusive coupon code, {{1}}, *expires in only {{2}} days!* Don’t miss out on our special deals. Use your code at checkout before it’s too late.\n\nHappy shopping! 😃",          "example": {            "body_text": [              [                "SUMMER20",                "10"              ]            ]          }        },        {          "type": "FOOTER",          "text": "Lucky Shrub Succulents"        },        {          "type": "BUTTONS",          "buttons": [            {              "type": "URL",              "text": "See deals",              "url": "https://www.luckyshrub.com/deals"            },            {              "type": "QUICK_REPLY",              "text": "Unsubscribe"            }          ]        }      ],      "language": "en",      "status": "APPROVED",      "category": "MARKETING",      "sub_category": "CUSTOM",      "id": "1304694804498707"    },    ...  ],  "paging": {    "cursors": {      "before": "QVFIU...",      "after": "QVFIU..."    },    "next": "https://graph.facebook.com/v23.0/10229..."  }}
+```
+
+### Obter todos os modelos e campos específicos
+
+Exemplo de solicitação para obter o nome, a categoria e o status de todos os modelos em uma conta do WhatsApp Business, limitando a resposta a 5 modelos por conjunto de resultados:
+
+```
+curl 'https://graph.facebook.com/v23.0/102290129340398/message_templates?fields=name,category,status&limit=5' \-H 'Authorization: Bearer EAAJB...'
+```
+
+Exemplo de resposta:
+
+```
+{  "data": [    {      "name": "reservation_confirmation",      "category": "UTILITY",      "status": "APPROVED",      "id": "1387372356726668"    },    {      "name": "coupon_expiration_reminder_number_vars",      "category": "MARKETING",      "status": "APPROVED",      "id": "1304694804498707"    },    {      "name": "coupon_expiration_reminder_named_vars",      "category": "MARKETING",      "status": "APPROVED",      "id": "1625063511800527"    },    {      "name": "address_update",      "category": "UTILITY",      "status": "PENDING",      "id": "1137051647947973"    },    {      "name": "reservation_confirmation_short_banner",      "category": "UTILITY",      "status": "REJECTED",      "id": "1166414785519855"    }  ],  "paging": {    "cursors": {      "before": "QVFIU...",      "after": "QVFIU..."    },    "next": "https://graph.facebook.com/v23.0/10229..."  }}
+```
+
+### Obter todos os modelos aprovados e rejeitados
+
+Exemplo de solicitação para obter todos os modelos aprovados e os respectivos nomes, categorias e status (troque `status=approved` por `status=rejected` para obter modelos rejeitados):
+
+```
+curl 'https://graph.facebook.com/v23.0/102290129340398/message_templates?fields=name,category,status&status=approved' \-H 'Authorization: Bearer EAAJB...'
+```
+
+Exemplo de resposta:
+
+```
+{  "data": [    {      "name": "reservation_confirmation",      "category": "UTILITY",      "status": "APPROVED",      "id": "1387372356726668"    },    {      "name": "coupon_expiration_reminder_number_vars",      "category": "MARKETING",      "status": "APPROVED",      "id": "1304694804498707"    },    {      "name": "coupon_expiration_reminder_named_vars",      "category": "MARKETING",      "status": "APPROVED",      "id": "1625063511800527"    },    {      "name": "calling_permission_request",      "category": "MARKETING",      "status": "APPROVED",      "id": "1092999222892024"    },    {      "name": "location_request_v1",      "category": "MARKETING",      "status": "APPROVED",      "id": "3373761659571648"    },    {      "name": "order_confirmation",      "category": "UTILITY",      "status": "APPROVED",      "id": "1667696820637468"    }  ],  "paging": {    "cursors": {      "before": "QVFIU...",      "after": "QVFIU..."    },    "next": "https://graph.facebook.com/v23.0/10229..."  }}
+```
+
+## Editar modelos
+
+Use o ponto de extremidade [POST /<TEMPLATE\_ID>](/documentation/business-messaging/whatsapp/reference/whatsapp-business-account/template-api#Updating) para editar um modelo. Você também pode usar o painel [Modelos de mensagem](https://business.facebook.com/latest/whatsapp_manager/message_templates) no Gerenciador do WhatsApp para editar modelos.
+
+### Limitações
+
+-   É possível editar somente os modelos com status `APPROVED`, `REJECTED` ou `PAUSED`.-   Só é possível editar a categoria, os componentes ou o tempo de vida de um modelo.-   Não é possível editar componentes individuais do modelo. Todos os componentes serão substituídos por aqueles que estiverem na carga da solicitação de edição.-   Não é possível editar a categoria de um modelo aprovado.-   Os modelos aprovados podem ser editados até 10 vezes dentro de 30 dias ou uma vez dentro de 24 horas. Não há restrição para o número de edições de modelos rejeitados ou pausados.-   Depois de editar um modelo aprovado ou pausado, ele será aprovado automaticamente, a não ser que seja reprovado na análise do modelo.
+
+### Editar categoria de modelo
+
+Exemplo de solicitação:
+
+```
+curl 'https://graph.facebook.com/v23.0/1252715608684590' \-H 'Content-Type: application/json' \-H 'Authorization: Bearer EAAJB...' \-d '{  "category": "MARKETING"}'
+```
+
+Exemplo de resposta:
+
+```
+{  "success": true}
+```
+
+### Editar componentes do modelo
+
+Exemplo de solicitação para substituir componentes existentes de um modelo por novos componentes.
+
+```
+curl 'https://graph.facebook.com/v23.0/564750795574598' \-H 'Content-Type: application/json' \-H 'Authorization: Bearer EAAJB...' \-d '{  "components": [    {      "type": "HEADER",      "format": "TEXT",      "text": "Our {{1}} is on!",      "example": {        "header_text": [          "Spring Sale"        ]      }    },    {      "type": "BODY",      "text": "Shop now through {{1}} and use code {{2}} to get {{3}} off of all merchandise.",      "example": {        "body_text": [          [            "the end of April",            "25OFF",            "25%"          ]        ]      }    },    {      "type": "FOOTER",      "text": "Use the buttons below to manage your marketing subscriptions"    },    {      "type": "BUTTONS",      "buttons": [        {          "type": "QUICK_REPLY",          "text": "Unsubscribe from Promos"        },        {          "type": "QUICK_REPLY",          "text": "Unsubscribe from All"        }      ]    }  ]}'
+```
+
+## Excluir modelos
+
+Use o ponto de extremidade [DELETE /<WHATSAPP\_BUSINESS\_ACCOUNT\_ID/message\_templates](/documentation/business-messaging/whatsapp/reference/whatsapp-business-account/template-api#Deleting) para excluir um modelo por nome ou ID.
+
+### Limitações
+
+-   Se você excluir um modelo enviado em uma mensagem que ainda não foi entregue (por exemplo, porque o telefone do cliente está desligado), o status do modelo será definido como `PENDING_DELETION`, e tentaremos entregar a mensagem por 30 dias. Se você tiver uma _API Local_, receberá um erro `Structure Unavailable` após esse período, e o cliente não receberá a mensagem.-   Se você excluir um modelo aprovado, não será possível criar um novo modelo com o mesmo nome por 30 dias.-   Os modelos com status desabilitado não podem ser excluídos.
+
+### Excluir modelo por nome
+
+Ao excluir um modelo por nome, você removerá todos os modelos com essa nomenclatura. Isso significa que modelos com o mesmo nome, mas idiomas diferentes, também serão excluídos.
+
+Exemplo de solicitação:
+
+```
+curl -X DELETE 'https://graph.facebook.com/v23.0/102290129340398/message_templates?name=order_confirmation' \-H 'Authorization: Bearer EAAJB...'
+```
+
+Exemplo de resposta:
+
+```
+{  "success": true}
+```
+
+### Excluir um modelo por identificação
+
+Para excluir um modelo por identificação, inclua a identificação junto com o nome do modelo na sua solicitação. Apenas o modelo com essa identificação será excluído.
+
+Exemplo de solicitação:
+
+```
+curl -X DELETE 'https://graph.facebook.com/v23.0/102290129340398/message_templates?hsm_id=1407680676729941&name=order_confirmation' \-H 'Authorization: Bearer EAAJB...'
+```
+
+### Exemplo de resposta:
+
+```
+{  "success": true}
+```
+
+## Obter o namespace do modelo
+
+_Apenas usuários da API Local._
+
+Use o ponto de extremidade [GET /<WHATSAPP\_BUSINESS\_ACCOUNT\_ID>](/documentation/business-messaging/whatsapp/reference/whatsapp-business-account/whatsapp-business-account-api#Reading) e inclua o campo `message_template_namespace` para obter o namespace de um modelo.
+
+Exemplo de sintaxe da solicitação:
+
+```
+curl 'https://graph.facebook.com/v23.0/102290129340398?fields=message_template_namespace' \-H 'Authorization: Bearer EAAJB...'
+```
+
+Exemplo de resposta:
+
+```
+{  "message_template_namespace": "ba30dd89_2ebd_41e4_b805_f2c05ae04cc9",  "id": "102290129340398"}
+```
+
+Você achou esta página útil?
+
+![Ícone de polegar para cima](https://static.xx.fbcdn.net/rsrc.php/yR/r/OEXJ0_DJeZv.svg)
+
+![Ícone de polegar para baixo](https://static.xx.fbcdn.net/rsrc.php/yb/r/qKPgNVNeatU.svg)

package/docs/modelos/gerenciamento_de_modelos/template_media.md

@@ -0,0 +1,8 @@
+<!-- Source: https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/template-media -->
+<!-- Scraped: 2025-12-20T17:33:31.199Z -->
+
+## Esta página não está disponível no momento
+
+Isso pode ter ocorrido devido a um erro técnico que estamos trabalhando para corrigir. Tente recarregar esta página.
+
+Recarregar página

package/docs/modelos/gerenciamento_de_modelos/template_migration.md

@@ -0,0 +1,164 @@
+<!-- Source: https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/template-migration -->
+<!-- Scraped: 2025-12-20T17:33:38.614Z -->
+
+# Migração de modelo
+
+Updated: 14 de nov de 2025
+
+Este documento descreve como migrar modelos de uma conta do WhatsApp Business para outra. Esse processo não move os modelos, mas os recria na WABA de destino.
+
+## Limitações
+
+-   Os modelos só podem ser migrados entre WABAs que pertencem à mesma empresa da Meta.-   Apenas os modelos com status de `APPROVED` e `quality_score` de `GREEN` ou `UNKNOWN` são qualificados para migração.
+
+## Sintaxe da solicitação
+
+Use o ponto de extremidade [Conta do WhatsApp Business > Migrar modelos de mensagem](/docs/graph-api/reference/whats-app-business-account/migrate_message_templates) para migrar modelos de uma WABA para outra.
+
+```
+curl -X POST "https://graph.facebook.com/<API_VERSION>/<DESTINATION_WABA_ID>/migrate_message_templates" \
+-H "Authorization: Bearer <ACCESS_TOKEN>" \
+-H "Content-Type: application/json" \
+-d '
+{
+  "source_waba_id": "<SOURCE_WABA_ID>",
+  "page_number": <PAGE_NUMBER>,
+  "count": <COUNT><!-- only if migrating specific templates that failed to migrate -->
+  "template_ids": [<TEMPLATE_IDS>]
+}'
+```
+
+### Parâmetros
+
+Espaço reservado
+
+Descrição
+
+Valor de exemplo
+
+`<ACCESS_TOKEN>`
+
+_String_
+
+**Obrigatório.**
+
+[Token do sistema](/documentation/business-messaging/whatsapp/access-tokens#system-user-access-tokens) ou [token da empresa](/documentation/business-messaging/whatsapp/access-tokens#business-integration-system-user-access-tokens).
+
+`EAAAN6tcBzAUBOZC82CW7iR2LiaZBwUHS4Y7FDtQxRUPy1PHZClDGZBZCgWdrTisgMjpFKiZAi1FBBQNO2IqZBAzdZAA16lmUs0XgRcCf6z1LLxQCgLXDEpg80d41UZBt1FKJZCqJFcTYXJvSMeHLvOdZwFyZBrV9ZPHZASSqxDZBUZASyFdzjiy2A1sippEsF4DVV5W2IlkOSr2LrMLuYoNMYBy8xQczzOKDOMccqHEZD`
+
+`<API_VERSION>`
+
+_String_
+
+**Opcional.**
+
+Versão da Graph API.
+
+v24.0
+
+`<COUNT>`
+
+_Número inteiro_
+
+**Opcional.**
+
+Substitui o tamanho de lote padrão por uma contagem máxima de 500.
+
+Se a solicitação demorar mais de 30 segundos para ser executada e expirar, reduza o número de contagem.
+
+`200`
+
+`<DESTINATION_WABA_ID>`
+
+_Identificação da conta do WhatsApp Business_
+
+**Obrigatório.**
+
+Identificação da conta do WhatsApp Business de destino.
+
+`104996122399160`
+
+`<PAGE_NUMBER>`
+
+_Número inteiro_
+
+**Opcional.**
+
+Indica a quantidade de modelos que serão migrados em conjuntos de 500, com indexação a partir de zero. Por exemplo, para migrar 1.000 modelos, envie, em paralelo, uma solicitação com o valor definido como `0` e outra com o valor definido como `1`.
+
+`0`
+
+`<TEMPLATE_IDS>`
+
+_Matriz de strings_
+
+**Opcional.**
+
+Use apenas para migrar identificações de modelo específicas com uma matriz de tamanho máximo 500. Por exemplo, para migrar identificações de modelo com falha, adicione identificação específica da matriz.
+
+`["35002248699842","351234565148","54382248699842"]`
+
+`<SOURCE_WABA_ID>`
+
+_Identificação da conta do WhatsApp Business_
+
+**Obrigatório.**
+
+Identificação da conta do WhatsApp Business de origem.
+
+`102290129340398`
+
+## Resposta
+
+```
+{
+  "migrated_templates": [<MIGRATED_TEMPLATES>],
+  "failed_templates": [<FAILED_TEMPLATES>]
+}
+```
+
+### Propriedades de resposta
+
+Espaço reservado
+
+Descrição
+
+Valor de exemplo
+
+`<MIGRATED_TEMPLATES>`
+
+_Lista_
+
+A lista de IDs dos modelos que foram duplicados na conta do WhatsApp Business de destino.
+
+`"1473688840035974","6162904357082268","6147830171896170"`
+
+`<FAILED_TEMPLATES>`
+
+_Mapa_
+
+O mapa identificando modelos que não foram duplicados na conta do WhatsApp Business de destino.
+
+  
+As chaves são os IDs dos modelos, e os valores são os motivos de falha.
+
+`"1019496902803242":"Incorrect category",``"259672276895259":"Formatting error - dangling parameter",``"572279198452421":"Incorrect category"`
+
+## Exemplo de solicitação
+
+```
+curl -X POST 'https://graph.facebook.com/v24.0/104996122399160/migrate_message_templates?source_waba_id=102290129340398&page_number=0' \
+-H 'Authorization: Bearer EAAJB...'
+```
+
+## Exemplo de resposta
+
+```
+{  "migrated_templates": [    "1473688840035974",    "6162904357082268",    "6147830171896170"  ],  "failed_templates": {    "1019496902803242": "Incorrect category",    "259672276895259": "Formatting error - dangling parameter",    "572279198452421": "Incorrect category"  }}
+```
+
+Você achou esta página útil?
+
+![Ícone de polegar para cima](https://static.xx.fbcdn.net/rsrc.php/yR/r/OEXJ0_DJeZv.svg)
+
+![Ícone de polegar para baixo](https://static.xx.fbcdn.net/rsrc.php/yb/r/qKPgNVNeatU.svg)

package/docs/modelos/gerenciamento_de_modelos/template_pacing.md

@@ -0,0 +1,38 @@
+<!-- Source: https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/template-pacing -->
+<!-- Scraped: 2025-12-20T17:33:46.364Z -->
+
+# Regularidade do modelo
+
+Updated: 22 de out de 2025
+
+Esse recurso permite aos clientes dar feedback antecipado sobre os modelos. Com ele, é possível identificar e [pausar os modelos](/documentation/business-messaging/whatsapp/templates/template-pausing) que receberam feedback insatisfatório ou que apresentarem baixo engajamento. Dessa forma, você tem tempo suficiente para ajustar o conteúdo antes que ele seja enviado a uma grande quantidade de clientes, reduzindo a probabilidade de um feedback negativo afetar seus negócios.
+
+O mecanismo de regularidade é válido para modelos de marketing e de utilidade. Modelos recém-criados, modelos pausados que são retomados e modelos que podem ter sido criados anteriormente mas que não têm uma classificação de qualidade `GREEN` estão potencialmente sujeitos ao mecanismo de regularidade. O histórico de qualidade do modelo (por exemplo, uma pausa resultante de baixa qualidade) é um dos principais motivos para acionar a regularidade, e você poderá ver outros modelos sujeitos ao mecanismo. Quando um modelo é sujeito ao mecanismo de regularidade, as mensagens são enviadas normalmente até que um limite não especificado seja atingido. Quando o limite for atingido, as mensagens subsequentes que usarem esse modelo serão retidas a fim de garantir tempo suficiente para o feedback do cliente. Assim que recebermos um sinal de boa qualidade, as mensagens subsequentes usando esse modelo serão enviadas para todo o público-alvo. Se recebermos um sinal de má qualidade, as mensagens subsequentes usando esse modelo serão descartadas para que você tenha a oportunidade de ajustar o conteúdo, o direcionamento e assim por diante.
+
+## Regularidade do modelo de utilidade
+
+Os modelos de utilidade estarão sujeitos à regularidade somente se um modelo de utilidade tiver sido pausado. Depois que um modelo de utilidade for pausado, os modelos recém-criados, os modelos pausados que são retomados e os modelos que podem ter sido criados anteriormente, mas que não têm classificação de qualidade VERDE, estarão potencialmente sujeitos ao mecanismo de regularidade nos próximos 7 dias.
+
+## Comportamento da API
+
+A resposta imediata do ponto de extremidade de mensagens indicará se a mensagem foi enviada ou retida com a nova propriedade `message_status` no objeto `message`. Esta resposta estará disponível em todas as versões da API.
+
+-   A API de Nuvem sempre incluirá uma propriedade `message_status` que terá o valor `accepted` para mensagens processadas e `held_for_quality_assessment` para mensagens retidas. As mensagens aceitas dispararão os webhooks `sent` e `delivered` quando tiverem de fato sido enviadas. Esse é o mesmo comportamento que existia antes do mecanismo de regularidade. Confira um exemplo completo de resposta na documentação da API de Nuvem.
+
+Se o feedback for positivo e alterar a classificação do modelo para alta qualidade, as mensagens retidas serão liberadas e enviadas normalmente. O campo `message_template_quality_update` enviará a atualização de qualidade, e o webhook `messages` encaminhará as atualizações enviadas e entregues.
+
+Se o feedback for negativo e alterar a qualidade do modelo para baixa:
+
+-   o `status` do modelo será definido como `PAUSED`-   `message_template_status_update` será enviado com o valor do evento `paused`-   Cada mensagem retida será descartada e acionará um webhook `messages` com `"status":"failed"` e `"code":"132015"` (usuários da API de Nuvem).-   Um webhook `message_template_quality_update` será acionado com a alteração de qualidade;-   Os administradores da empresa proprietária da conta do WhatsApp Business serão informados sobre as mensagens descartadas por meio de uma notificação no Meta Business Suite, banner do Gerenciador do WhatsApp e email.
+
+Consulte [Pausa no modelo](/documentation/business-messaging/whatsapp/templates/template-pausing) para saber como retomar um modelo que foi pausado devido à regularidade.
+
+Temos proteções internas em vigor a fim de garantir que nossos processos de avaliação e decisão em relação à regularidade sejam concluídos em um prazo razoável para evitar impacto em campanhas urgentes. Nosso objetivo é que, mesmo com a regularidade, as mensagens de campanha de maior taxa de transferência de dados ainda sejam entregues em até uma hora (percentil 99).
+
+Por isso, se os nossos limites internos forem atingidos antes de o modelo receber feedback suficiente para alterar a qualidade para alta ou baixa, as mensagens retidas serão liberadas normalmente com os webhooks apropriados.
+
+Você achou esta página útil?
+
+![Ícone de polegar para cima](https://static.xx.fbcdn.net/rsrc.php/yR/r/OEXJ0_DJeZv.svg)
+
+![Ícone de polegar para baixo](https://static.xx.fbcdn.net/rsrc.php/yb/r/qKPgNVNeatU.svg)

package/docs/modelos/gerenciamento_de_modelos/template_pausing.md

@@ -0,0 +1,58 @@
+<!-- Source: https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/template-pausing -->
+<!-- Scraped: 2025-12-20T17:33:54.259Z -->
+
+# Pausa no modelo
+
+Updated: 22 de out de 2025
+
+Se o modelo de mensagem atingir a classificação de qualidade mais baixa (status **Ativo – Qualidade baixa** no Gerenciador do WhatsApp ou `quality_score` de `RED` via API), ele será automaticamente pausado por um período para proteger a classificação de qualidade dos números de telefone que o usaram. As durações das pausas são as seguintes:
+
+-   1ª instância: pausado por 3 horas-   2ª instância: pausado por 6 horas-   3ª instância: desabilitado
+
+Quando um modelo de mensagem é pausado (status **Pausado**), ele não pode ser enviado aos clientes. Por isso, você precisa interromper as campanhas de mensagens automáticas que dependam desse modelo. Apesar de a tentativa de envio de um modelo pausado não ser cobrada e não contar contra o limite de mensagens, a API as rejeitará. Só retome o envio das campanhas quando o status do modelo for definido como "Ativo" novamente.
+
+Você poderá editar um modelo pausado caso acredite que isso fará com que ele receba menos feedback negativo e melhore o índice de engajamento. Porém, ao fazer isso, o modelo ficará com o status Em análise e não poderá ser enviado aos clientes até que seja aprovado novamente e tenha o status Ativo.
+
+Também é possível alterar a lógica dos negócios (direcionamento, parâmetros de entrega, entre outros) caso você acredite que isso esteja contribuindo para o feedback negativo ou para o baixo índice de engajamento.
+
+Inicialmente, a pausa não afetará o número de telefone comercial do qual o modelo de mensagem foi enviado. Outros modelos de mensagem com alta qualidade podem continuar sendo enviados do número de telefone. Entretanto, se a empresa continuar usando modelos com Qualidade baixa depois de eles serem pausados, o número de telefone poderá ser afetado em algum momento.
+
+## Notificações de pausa
+
+Quando um modelo de mensagem for pausado, você receberá uma notificação do Gerenciador de Negócios e um e-mail, além disso, um webhook [message\_template\_status\_update](/documentation/business-messaging/whatsapp/webhooks/reference/message_template_status_update).
+
+### Como retomar
+
+O modelo será retomado automaticamente depois da conclusão da pausa descrita acima. Depois de retomado, o modelo terá status **Ativo** e poderá ser enviado aos clientes novamente. Caso você não tenha interrompido as campanhas de mensagens automáticas que dependiam do modelo, elas voltarão a funcionar. No entanto, recomendamos que você interrompa as campanhas que dependam de modelos suspensos até que eles sejam retirados da pausa, porque nossas APIs rejeitarão as solicitações.
+
+A [classificação de qualidade](/documentation/business-messaging/whatsapp/templates/template-quality) do modelo também será definida para um valor baseado no feedback mais recente.
+
+Assim como as notificações de pausa, enviaremos notificações pelo Gerenciador do WhatsApp, por email e webhook quando o status do modelo for definido como Ativo.
+
+Esse recurso ficará disponível para empresas no Brasil, na Colômbia e em Singapura a partir de 12 de setembro de 2023 e para todas as empresas em 12 de outubro de 2023.
+
+Com o lançamento do recurso Regularidade do Modelo, também disponibilizaremos a capacidade de retomar modelos pausados das seguintes formas:
+
+-   Com a API, faça uma solicitação POST a `/{whats_app_message_template_id}/unpause`-   No Gerenciador do WhatsApp, clique no link para **retomar manualmente**, destacado nas capturas de tela exibidas abaixo.
+
+Importante: os modelos pausados durante o funcionamento do mecanismo Regularidade do Modelo precisam ser retomados manualmente (via API ou Gerenciador do WhatsApp) antes de serem usados outra vez.
+
+![](https://scontent-gru2-1.xx.fbcdn.net/v/t39.2365-6/554797102_3175363515964237_8084410644890844296_n.png?_nc_cat=107&ccb=1-7&_nc_sid=e280be&_nc_ohc=VdSb4SbAbP4Q7kNvwGhGK2G&_nc_oc=Adn7nU5_VSuF8zpiz9xTZJDLcNkQyDBCgbymz6bQR9BLh2mgs0DQ5SmIyxYolm0Gbgg&_nc_zt=14&_nc_ht=scontent-gru2-1.xx&_nc_gid=tg6hO77dX4aoTktwUzVIGw&oh=00_AfnrVF-VSNCqhrWILCEGYNi0uev2uN9YHRxl_ajfE1w-GA&oe=69611118)
+
+![](https://scontent-gru2-1.xx.fbcdn.net/v/t39.2365-6/554106571_1492926028278417_4141428697407616298_n.png?_nc_cat=107&ccb=1-7&_nc_sid=e280be&_nc_ohc=m4VMnmfK0vQQ7kNvwEA4g1_&_nc_oc=AdlTaZ1cCWWzKtz9VvA57POc2mX6PaZ9N2FJwdHS7tOrnn0CDQfusyDzlf-QPlg-w6w&_nc_zt=14&_nc_ht=scontent-gru2-1.xx&_nc_gid=tg6hO77dX4aoTktwUzVIGw&oh=00_AfmJZ0on3A8pUbV7yw2CUHvZyYDdf7TFemwgqSqp3BzOIA&oe=69612111)
+
+### Apelações
+
+Caso o envio seja rejeitado, você poderá fazer uma apelação. Lembre-se de que as apelações devem incluir uma amostra. Se um modelo aprovado for desabilitado, você também poderá editá-lo e reenviá-lo para aprovação.
+
+No Gerenciador do WhatsApp:
+
+-   Passe o mouse sobre o ícone de mala (**Ferramentas da conta**) e clique em **Modelos de mensagem**.-   Se você tiver várias contas do WhatsApp Business, use o menu suspenso no canto superior direito para selecionar a conta cujos modelos você quer gerenciar.-   Encontre o modelo de mensagem que você quer de editar e clique nele.-   Edite o conteúdo do modelo.-   Clique no botão **Adicionar exemplo**. Adicione as variáveis de valores e imagens.-   Clique em **Enviar**.
+
+Analisaremos a apelação e tomaremos uma decisão dentro de 24 horas.
+
+Você achou esta página útil?
+
+![Ícone de polegar para cima](https://static.xx.fbcdn.net/rsrc.php/yR/r/OEXJ0_DJeZv.svg)
+
+![Ícone de polegar para baixo](https://static.xx.fbcdn.net/rsrc.php/yb/r/qKPgNVNeatU.svg)

package/docs/modelos/gerenciamento_de_modelos/template_quality.md

@@ -0,0 +1,47 @@
+<!-- Source: https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/template-quality -->
+<!-- Scraped: 2025-12-20T17:34:19.183Z -->
+
+# Classificação de qualidade do modelo
+
+Updated: 29 de out de 2025
+
+Os modelos têm uma classificação de qualidade baseada no uso, no feedback dos clientes e no engajamento. Os modelos podem ter as seguintes classificações, conforme informado pela API:
+
+-   `GREEN` – Indica alta qualidade. O modelo recebeu pouco ou nenhum feedback negativo dos usuários do WhatsApp. O modelo pode ser enviado.-   `YELLOW` – Indica qualidade média. O modelo recebeu feedback negativo de diversos usuários do WhatsApp ou apresenta baixa taxa de leitura e pode ser pausado ou desabilitado em breve. Os modelos de mensagem com esse status podem ser enviados.-   `RED` – Indica baixa qualidade. O modelo recebeu feedback negativo de vários usuários do WhatsApp ou apresenta baixa taxa de leitura. O modelo pode ser enviado, mas corre o risco de ser pausado ou desabilitado em breve. Recomendamos que você resolva os problemas que os usuários estão relatando.-   `UNKNOWN` – Indica que a pontuação de qualidade ainda está pendente, porque ainda não recebeu o feedback do usuário do WhatsApp ou os dados de taxa de leitura. O modelo pode ser enviado.
+
+Os modelos recém-criados têm uma pontuação de qualidade inferior a `UNKNOWN`. Porém, a classificação mudará automaticamente conforme uso, feedback e sinal de engajamento são coletados ao longo do tempo.
+
+As classificações de qualidade influenciam o [tempo de regularidade](/documentation/business-messaging/whatsapp/templates/template-pacing) e a [pausa do modelo](/documentation/business-messaging/whatsapp/templates/template-pausing), o que pode afetar a entrega. Se um modelo receber feedback negativo ou apresentar baixo índice de engajamento de forma contínua, isso pode causar uma mudança de status. Caso o status seja alterado para qualquer outra coisa que não `APPROVED`, o modelo não poderá ser enviado em mensagens de modelo, a menos que o status `APPROVED` seja restaurado.
+
+## Obter a classificação de qualidade do modelo via API
+
+Use o ponto de extremidade [GET /<TEMPLATE\_ID>](/documentation/business-messaging/whatsapp/reference/whatsapp-business-account/template-api#Reading) e solicite o campo `quality_score` para obter a pontuação de qualidade de um modelo.
+
+### Exemplo de solicitação
+
+```
+curl 'https://graph.facebook.com/v24.0/1105258428396250?fields=quality_score' \
+-H 'Authorization: Bearer EAAJB...'
+```
+
+### Exemplo de resposta
+
+```
+{  "quality_score": {    "score": "GREEN",    "date": 1758754645  },  "id": "1387372356726668"}
+```
+
+## Obter a classificação de qualidade do modelo por meio do Gerenciador do WhatsApp
+
+O painel [Gerenciar modelos](https://business.facebook.com/latest/whatsapp_manager/message_templates) no Gerenciador do WhatsApp também exibe as classificações de qualidade para modelos aprovados:
+
+-   Ativo – **Qualidade pendente** (equivalente a uma pontuação de qualidade `UNKNOWN`)-   Ativo – **Alta qualidade** (equivalente a uma pontuação de qualidade `GREEN`)-   Ativo – **Qualidade média** (equivalente a uma pontuação de qualidade `YELLOW`)-   Ativo – **Baixa qualidade** (equivalente a uma pontuação de qualidade `RED`)
+
+## Veja também
+
+-   [Sobre a classificação de qualidade do seu modelo de mensagem do WhatsApp Business](https://www.facebook.com/business/help/766346674749731)
+
+Você achou esta página útil?
+
+![Ícone de polegar para cima](https://static.xx.fbcdn.net/rsrc.php/yR/r/OEXJ0_DJeZv.svg)
+
+![Ícone de polegar para baixo](https://static.xx.fbcdn.net/rsrc.php/yb/r/qKPgNVNeatU.svg)

package/docs/modelos/gerenciamento_de_modelos/template_review.md

@@ -0,0 +1,74 @@
+<!-- Source: https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/template-review -->
+<!-- Scraped: 2025-12-20T17:34:26.426Z -->
+
+# Análise do modelo
+
+Updated: 31 de out de 2025
+
+A API de Nuvem usa machine learning para analisar os modelos e os parâmetros variáveis, além de proteger a segurança e a integridade dos serviços. Durante essa análise, nenhuma informação é compartilhada com o WhatsApp.
+
+Quando você envia uma solicitação de criação de modelo, o conteúdo passa por validação por meio de uma combinação de sistemas automatizados e análises manuais. Esse processo garante que o modelo esteja em conformidade com as políticas e os padrões de qualidade do WhatsApp. Modelos que contenham spam, conteúdo semelhante a golpe ou que violem as políticas do WhatsApp são rejeitados durante esse processo de análise.
+
+## Processo de aprovação
+
+Depois de criar o modelo, você poderá enviá-lo para aprovação. Pode levar até 24 horas para que uma decisão de aprovação seja tomada. Assim que a decisão for tomada, uma notificação aparecerá no Gerenciador do WhatsApp. Além disso, enviaremos um email para os administradores do Gerenciador de Negócios. Além disso, enviaremos um webhook [message\_template\_status\_change](/documentation/business-messaging/whatsapp/webhooks/reference/message_template_status_update).
+
+Caso seja aprovado, o modelo de mensagem ficará com o status **Ativo – Qualidade pendente** (`APPROVED` na API). Com isso, você poderá começar a enviá-lo aos clientes. Caso seja rejeitado, você poderá editar e reenviá-lo para aprovação, ou apelar da decisão.
+
+### Exemplos
+
+Se o seu modelo usa variáveis, o envio deve conter valores variáveis de exemplo (ativos de mídia, strings de texto etc.). Com isso, fica mais fácil visualizarmos como o modelo aparecerá para os clientes.
+
+Para incluir uma amostra no envio no Gerenciador do WhatsApp, primeiro crie o modelo, adicionando as variáveis necessárias, depois clique no botão Adicionar amostra. O painel de pré-visualização renderizará os exemplos de ativos de mídia ou valores de texto fornecidos.
+
+## Motivos comuns para rejeição
+
+Estes são os erros mais comuns que levam à rejeição do envio e devem ser evitados:
+
+### Formatação de parâmetros
+
+-   Os parâmetros variáveis estão ausentes ou apresentam chaves incompatíveis. O formato correto é `{{1}}` para parâmetros posicionais.-   Os parâmetros variáveis têm caracteres especiais, como `#`, `$` ou `%`.-   Os parâmetros variáveis não são sequenciais. Por exemplo, `{{1}}`, `{{2}}`, `{{5}}`, `{{4}}`.-   O modelo contém muitos parâmetros variáveis em relação ao tamanho da mensagem. Você precisa diminuir o número de parâmetros variáveis ou aumentar o tamanho da mensagem.-   O modelo de mensagem não pode começar nem terminar com um parâmetro, ou seja, parâmetros pendentes não são permitidos.
+
+### Violações à política e ao conteúdo
+
+-   O modelo de mensagem apresenta conteúdo que viola a Política Comercial do WhatsApp: quando você promove a venda de bens e serviços, todas as mídias e mensagens relacionadas aos seus produtos são consideradas transações. Isso inclui descrições, preços, tarifas, impostos e/ou divulgações legais obrigatórias. As transações precisam estar em conformidade com a Política Comercial do WhatsApp.-   O modelo de mensagem tem conteúdo que viola a Política do WhatsApp Business: não solicite identificadores sensíveis aos usuários. Por exemplo, não peça aos clientes que compartilhem números completos de cartões de crédito e débito individuais, números de contas bancárias, números de identificação nacional nem outras informações confidenciais. Isso inclui não solicitar aos usuários documentos que possam conter identificadores sensíveis. Solicitar identificadores parciais (por exemplo, os últimos 4 dígitos do CPF) é aceitável.-   O conteúdo é potencialmente abusivo ou ameaçador. Por exemplo, ameaça o cliente com ações legais ou constrangimento público.
+
+### Limites de caracteres e formato de texto
+
+O componente de corpo tem diferentes limites de caracteres conforme o formato e a tag de modelo. O número de emojis permitido no componente também pode ser limitado.
+
+### Duplicação
+
+O modelo de mensagem é uma duplicata de um existente. Se um modelo for enviado com o mesmo texto de um existente no corpo e no rodapé, a duplicata será rejeitada.
+
+### Notificações de rejeição
+
+Uma notificação de rejeição com o motivo da recusa será exibida na Página Inicial do Suporte para Empresas. Você pode ver as rejeições na Página Inicial do Suporte para Empresas, basta navegar até **Visão geral da conta** > **Ver minhas contas** (botão) > (sua conta comercial da Meta) > (sua WABA) > **Modelos de mensagem rejeitados**.
+
+As informações sobre a rejeição também serão enviadas por email.
+
+Na notificação da Página Inicial do Suporte para Empresas, é possível consultar o nome e o idioma do modelo existente que tem o mesmo conteúdo do duplicado rejeitado. Você também pode editar e reenviar o modelo.
+
+Observação: a verificação não se aplica a modelos categorizados como `AUTHENTICATION`.
+
+## Apelações
+
+Caso o envio seja rejeitado, você poderá fazer uma apelação. Lembre-se de que as apelações devem incluir uma amostra. Se um modelo aprovado for desabilitado, você também poderá editá-lo e reenviá-lo para aprovação.
+
+### No Gerenciador do WhatsApp:
+
+-   Passe o mouse sobre o ícone de mala (Ferramentas da conta) e clique em Modelos de mensagem. Se você tiver várias contas do WhatsApp Business, use o menu suspenso no canto superior direito para selecionar a conta cujos modelos você quer gerenciar.-   Encontre o modelo de mensagem que você quer de editar e clique nele.-   Edite o conteúdo do modelo.-   Clique no botão **Adicionar exemplo**. Adicione as variáveis de valores e imagens.-   Clique em **Enviar**.
+
+Analisaremos a apelação e tomaremos uma decisão dentro de 24 horas.
+
+## Webhooks de análise de modelo
+
+É possível receber atualizações por meio do webhook [message\_template\_status\_update](/documentation/business-messaging/whatsapp/webhooks/reference/message_template_status_update), que notifica se o modelo foi aprovado, rejeitado ou está pendente.
+
+Se o seu modelo for rejeitado e você não concordar com a decisão, será possível fazer uma apelação para que ele seja reconsiderado.
+
+Você achou esta página útil?
+
+![Ícone de polegar para cima](https://static.xx.fbcdn.net/rsrc.php/yR/r/OEXJ0_DJeZv.svg)
+
+![Ícone de polegar para baixo](https://static.xx.fbcdn.net/rsrc.php/yb/r/qKPgNVNeatU.svg)