whatsapp-docs-mcp 1.0.0

package/docs/parceiros/integracao_de_clientes/cadastro_incorporado/automatic_events_api.md

@@ -0,0 +1,204 @@
+<!-- Source: https://developers.facebook.com/documentation/business-messaging/whatsapp/embedded-signup/automatic-events-api -->
+<!-- Scraped: 2025-12-20T17:49:56.379Z -->
+
+# API de Eventos Automáticos
+
+Updated: 14 de nov de 2025
+
+Os clientes empresariais que acessam o cadastro incorporado têm a opção de aceitar a identificação automática de eventos:
+
+![](https://scontent-gru2-2.xx.fbcdn.net/v/t39.2365-6/503425036_1029531339304862_7305936950282438326_n.png?_nc_cat=106&ccb=1-7&_nc_sid=e280be&_nc_ohc=BoS4FY64_REQ7kNvwFyiXeY&_nc_oc=Adl95GSzyFcDFfJC9pyD-21_Lm3AJ6Vy41RmWwiR35vuF8SrurIvT5hiPD-CfyF_73k&_nc_zt=14&_nc_ht=scontent-gru2-2.xx&_nc_gid=xMCf1UPwuUdPEFagj-UVRw&oh=00_Afm5ggG6ygvLAMpg_wkMWVpXm2BdJeV-EYcb6D65TMFCRw&oe=69610BCD)
+
+Quando um cliente empresarial aceita, usamos uma combinação de expressões regulares e processamento de linguagem natural para analisar as novas conversas que são originadas por anúncios de clique para o WhatsApp. Se a nossa análise determinar que houve um evento de geração de lead ou de compra, você poderá receber uma notificação ao assinar o campo de webhook **automatic\_events**. Depois, você pode registrar o evento para o cliente usando a [API de Conversões](/docs/marketing-api/conversions-api) para que ele possa ser aproveitado pelo cliente usando uma plataforma da Meta (em 2026, consulte [Limitações](#limitations) abaixo).
+
+Para saber mais sobre como esse recurso funciona, veja estes [recursos adicionais](https://l.facebook.com/l.php?u=https%3A%2F%2Fmeta.highspot.com%2Fitems%2F6839e4fecd0bb354418ee7ec&h=AT2hVvDEJgRNcaJ-KenZxS6qDgk24Q5cu598D0DXYwvhGwSeqbQ62CMEB-b8Jbddj8UzW7tnrglYs7cgHVKR46oXr4kdKfnZSULI4hZrjWl8NQ1sbAlHZOs0EF-5FAZ4uLWgIAgLpL6dWG5a_gKRhCxrVvA).
+
+## Limitações
+
+-   A identificação automática de eventos é um recurso novo, portanto, seus clientes empresariais não poderão visualizar nem usar os eventos automáticos reportados por meio da API de Conversões em nenhuma superfície da Meta até 2026. No entanto, se quiser, você poderá exibir essas informações para seus clientes usando a própria solução antes disso, para que eles possam entender melhor as necessidades, preferências e o desempenho dos anúncios dos respectivos clientes.-   A identificação automática de eventos não está disponível para clientes empresariais na União Europeia, no Reino Unido ou no Japão.
+
+## Requisitos
+
+-   Você já [implementou](/documentation/business-messaging/whatsapp/embedded-signup/implementation) o Cadastro Incorporado e pode integrar clientes empresariais que concluírem o fluxo.-   Seu [servidor de webhook](/docs/graph-api/webhooks/getting-started/webhooks-for-whatsapp) está processando webhooks.
+
+## Configuração
+
+A identificação automática de eventos está disponível como recurso opcional para todos os clientes empresariais. Para receber notificações sobre um evento, você deve inscrever seu app no campo de webhook **automatic\_events**. No entanto, assim que fizer isso, talvez você comece a receber esses webhooks antes de conseguir processá-los. Sendo assim, recomendamos concluir essas etapas usando um app de teste antes de mover o código para a produção e inscrever o app de produção no campo de webhook.
+
+### Etapa 1: assinar o campo de webhook automatic\_events
+
+Navegue até [Painel de Apps](/apps) > **Webhooks** > **Configuração** e assine o campo de webhook **automatic\_events**.
+
+### Etapa 2: ajustar o retorno de chamada do webhook
+
+Ajuste o código de retorno de chamada do webhook para que ele possa processar cargas de webhook **automatic\_events**.
+
+#### Estrutura do evento de geração de leads
+
+```
+{
+  "object": "whatsapp_business_account",
+  "entry": [
+    {
+      "id": "<WHATSAPP_BUSINESS_ACCOUNT_ID>",
+      "changes": [
+        {
+          "value": {
+            "messaging_product": "whatsapp",
+            "metadata": {
+              "display_phone_number": "<BUSINESS_DISPLAY_PHONE_NUMBER>",
+              "phone_number_id": "<BUSINESS_PHONE_NUMBER_ID>"
+            },
+            "automatic_events": [
+              {
+                "id": "<WHATSAPP_MESSAGE_ID>",
+                "event_name": "LeadSubmitted",
+                "timestamp": <WEBHOOK_TRIGGER_TIMESTAMP>,
+                "ctwa_clid": "<CLICK_ID>"
+              }
+            ]
+          },
+          "field": "automatic_events"
+        }
+      ]
+    }
+  ]
+}
+```
+
+#### Exemplo de evento de geração de leads
+
+```
+{  "object": "whatsapp_business_account",  "entry": [    {      "id": "102290129340398",      "changes": [        {          "value": {            "messaging_product": "whatsapp",            "metadata": {              "display_phone_number": "15550783881",              "phone_number_id": "106540352242922"            },            "automatic_events": [              {                "id": "wamid.HBgLMTIwNjY3NzQ3OTgVAgASGBQzQUY3MDVCQzFBODE5ODU4MUZEOQA=",                "event_name": "LeadSubmitted",                "timestamp": 1749069089,                "ctwa_clid": "Afc3nYt4TTydumlFFsatFz8bR2yHCtVA92Veu_zDE4DgAI-QqCwM6eC3-K3lTGHRiLxRTVXFEsdyKQQSa-2obZyuGBq_EYypt_OwbMihBV0pbUoRmrGnEjwFTHop-Px0TfA"              }            ]          },          "field": "automatic_events"        }      ]    }  ]}
+```
+
+#### Estrutura do evento de compra
+
+```
+{
+  "object": "whatsapp_business_account",
+  "entry": [
+    {
+      "id": "<WHATSAPP_BUSINESS_ACCOUNT_ID>",
+      "changes": [
+        {
+          "value": {
+            "messaging_product": "whatsapp",
+            "metadata": {
+              "display_phone_number": "<BUSINESS_DISPLAY_PHONE_NUMBER>",
+              "phone_number_id": "<BUSINESS_PHONE_NUMBER_ID>"
+            },
+            "automatic_events": [
+              {
+                "id": "<WHATSAPP_MESSAGE_ID>",
+                "event_name": "Purchase",
+                "timestamp": <WEBHOOK_TRIGGER_TIMESTAMP>,
+                "ctwa_clid": "<CLICK_ID>",
+                "custom_data": {
+                  "currency": "<CURRENCY_CODE>",
+                  "value": <AMOUNT>
+                }
+              }
+            ]
+          },
+          "field": "automatic_events"
+        }
+      ]
+    }
+  ]
+}
+```
+
+#### Exemplo de evento de compra
+
+```
+{  "object": "whatsapp_business_account",  "entry": [    {      "id": "102290129340398",      "changes": [        {          "value": {            "messaging_product": "whatsapp",            "metadata": {              "display_phone_number": "15550783881",              "phone_number_id": "106540352242922"            },            "automatic_events": [              {                "id": "wamid.HBgLMTIwNjY3NzQ3OTgVAgARGBIwRkU4NDI5Nzk3RjZDMzE2RUMA",                "event_name": "Purchase",                "timestamp": 1749069131,                "ctwa_clid": "Afc3nYt4TTydumlFFsatFz8bR2yHCtVA92Veu_zDE4DgAI-QqCwM6eC3-K3lTGHRiLxRTVXFEsdyKQQSa-2obZyuGBq_EYypt_OwbMihBV0pbUoRmrGnEjwFTHop-Px0TfA",                "custom_data": {                  "currency": "USD",                  "value": 25000                }              }            ]          },          "field": "automatic_events"        }      ]    }  ]}
+```
+
+### Etapa 3: acionar webhooks
+
+Para acionar um webhook **automatic\_events**:
+
+-   Acesse a implementação de teste do cadastro incorporado-   Autentique o fluxo usando uma empresa que já tenha um anúncio de clique para o WhatsApp configurado.-   Na tela da seção WABA, marque a caixa de seleção **Instrua a Meta a identificar automaticamente eventos de pedidos e de leads** e conclua o fluxo.-   Acesse o anúncio de clique para o WhatsApp e clique nele para enviar uma mensagem à empresa.-   Use a empresa para responder à mensagem com uma das strings abaixo (deve ser exatamente igual).
+
+-   **Para um evento de compra:**_seu código de rastreamento é AB123456789BR_-   **Para um evento de geração de leads:**_Quero saber mais sobre o produto_
+
+Depois de disparar as cargas de webhook **automatic\_events**, confirme que o retorno de chamada do webhook processou cada webhook de acordo com as suas necessidades comerciais.
+
+### Etapa 4: registrar cada evento usando a API de Conversões (opcional)
+
+Se desejar, você pode registrar cada evento usando a [API de Conversões](/docs/marketing-api/conversions-api/business-messaging). Inclua valores relevantes do webhook de evento, conforme aplicável.
+
+Para saber mais sobre como registrar eventos, consulte [Enviar eventos por meio da API de Conversões](/docs/marketing-api/conversions-api/business-messaging#send-events-via-the-conversions-api-2).
+
+#### Sintaxe da geração de leads
+
+```
+curl 'https://graph.facebook.com/<API_VERSION>/<DATASET_ID>/events' \
+-H 'Content-Type: application/json' \
+-H 'Authorization: Bearer <ACCESS_TOKEN>' \
+-d '
+{
+  "data": [
+    {
+      "event_name": "LeadSubmitted",
+      "event_time": <WEBHOOK_TRIGGER_TIMESTAMP>,
+      "action_source": "business_messaging",
+      "messaging_channel": "whatsapp",
+      "user_data": {
+        "ctwa_clid": "<CLICK_ID>"
+      },
+      "messaging_outcome_data": {
+        "outcome_type": "automatic_events"
+      }
+    }
+  ]
+}
+'
+```
+
+#### Sintaxe do evento de compra
+
+```
+curl 'https://graph.facebook.com/<API_VERSION>/<DATASET_ID>/events' \
+-H 'Content-Type: application/json' \
+-H 'Authorization: Bearer <ACCESS_TOKEN>' \
+-d '
+{
+  "data": [
+    {
+      "event_name": "Purchase",
+      "event_time": <WEBHOOK_TRIGGER_TIMESTAMP>,
+      "action_source": "business_messaging",
+      "messaging_channel": "whatsapp",
+      "user_data": {
+        "ctwa_clid": "<CLICK_ID>"
+      },
+      "custom_data": {
+        "currency": "<CURRENCY_CODE>",
+        "value": <AMOUNT>
+      },
+      "messaging_outcome_data": {
+        "outcome_type": "automatic_events"
+      }
+    }
+  ]
+}
+'
+```
+
+## Habilitar e desabilitar via Meta Business Suite
+
+Os clientes empresariais já integrados por meio do cadastro incorporado podem habilitar a identificação automática de eventos usando o Meta Business Suite.
+
+![](https://scontent-gru2-1.xx.fbcdn.net/v/t39.2365-6/503429874_596845240111750_4726469615509960636_n.png?_nc_cat=111&ccb=1-7&_nc_sid=e280be&_nc_ohc=iZbrDlEPKjsQ7kNvwGg45Zk&_nc_oc=AdklAZzf9yMNmSLmBaTsoxFgUoZWHcAKGfKuYIjV-TldXuns1PWdUsgB9OIcP7GkCpE&_nc_zt=14&_nc_ht=scontent-gru2-1.xx&_nc_gid=xMCf1UPwuUdPEFagj-UVRw&oh=00_Afn4GlzAb-mAhZeiDBRcGqfmtBeJQZLyzB_dmXx-W7FlSQ&oe=696133AB)
+
+Se um cliente empresarial que você já integrou quiser habilitar esse recurso, envie as seguintes instruções:
+
+-   Acesse o Meta Business Suite em [https://business.facebook.com](https://business.facebook.com).-   Navegue até **Configurações** > **Contas** > **Contas do WhatsApp** e clique na sua conta do WhatsApp Business.-   Na aba **Resumo**, role a tela para baixo até **Privacidade e compartilhamento de dados**.-   Use o botão "**Identificar automaticamente**..." para habilitar ou desabilitar a identificação automática de eventos conforme desejado.
+
+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/parceiros/integracao_de_clientes/cadastro_incorporado/bypass_phone_addition.md

@@ -0,0 +1,52 @@
+<!-- Source: https://developers.facebook.com/documentation/business-messaging/whatsapp/embedded-signup/bypass-phone-addition -->
+<!-- Scraped: 2025-12-20T17:49:22.705Z -->
+
+# Inorar a tela de adição de número de telefone
+
+Updated: 14 de nov de 2025
+
+Este documento descreve como personalizar o Cadastro Incorporado para ignorar a [tela de adição do número de telefone](/documentation/business-messaging/whatsapp/embedded-signup/default-flow#phone-number-addition-screen) (mostrada abaixo) e a [tela de verificação do número de telefone](/documentation/business-messaging/whatsapp/embedded-signup/default-flow#phone-number-verification-screen).
+
+![](https://scontent-gru2-1.xx.fbcdn.net/v/t39.2365-6/464076811_858112679765152_5952854678961541773_n.png?_nc_cat=107&ccb=1-7&_nc_sid=e280be&_nc_ohc=JKekqEgfu_8Q7kNvwFxLZrw&_nc_oc=Adl9ey0fZDI4FXLPhch7JzRYBUmWrv9ad-xq8J_ne-9MAZrvPyVKPfZbMUEA7cklZ9I&_nc_zt=14&_nc_ht=scontent-gru2-1.xx&_nc_gid=6rDiBc1AlGLCwEcMvEzcnw&oh=00_AflUFwaLmz7WYJYNHnlpGhn7Zxx2FZH459MuW8SeRfxU6g&oe=6961230E)
+
+Se não quiser que seus clientes empresariais precisem inserir ou escolher um número de telefone comercial na tela de adição correspondente, você poderá personalizar o cadastro incorporado para ignorar essa tela. No entanto, depois que o cliente concluir o fluxo personalizado, você deverá [criar e registrar de forma programática o número de telefone comercial dele](/documentation/business-messaging/whatsapp/solution-providers/registering-phone-numbers) ou criar uma interface do usuário no seu app quepermita que isso seja feito.
+
+## Habilitar o recurso
+
+Para habilitar esse recurso, defina `featureType` como `only_waba_sharing` na parte de [método de inicialização e registro de retorno de chamada](/documentation/business-messaging/whatsapp/embedded-signup/implementation#launch-method-and-callback-registration) do código de Cadastro Incorporado:
+
+```
+// Launch method and callback registration
+const launchWhatsAppSignup = () => {
+  FB.login(fbLoginCallback, {
+    config_id: '<CONFIGURATION_ID>', // your configuration ID goes here
+    response_type: 'code',
+    override_default_response_type: true,
+    extras: {
+      setup: {},
+      featureType: 'only_waba_sharing', // set to only_waba_sharing
+      sessionInfoVersion: '3',
+    }
+  });
+}
+```
+
+Quando um cliente empresarial concluir o fluxo, o [evento de mensagem de registro da sessão](/documentation/business-messaging/whatsapp/embedded-signup/implementation#session-logging-message-event-listener) terá `event` definido como `FINISH_ONLY_WABA`:
+
+```
+{
+  data: {
+    phone_number_id: "<CUSTOMER_BUSINESS_PHONE_NUMBER_ID>",
+    waba_id: "<CUSTOMER_WABA_ID>"
+  },
+  type: "WA_EMBEDDED_SIGNUP",
+  event: "FINISH_ONLY_WABA",
+  version: 3
+}
+```
+
+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/parceiros/integracao_de_clientes/cadastro_incorporado/custom_flows.md

@@ -0,0 +1,40 @@
+<!-- Source: https://developers.facebook.com/documentation/business-messaging/whatsapp/embedded-signup/custom-flows -->
+<!-- Scraped: 2025-12-20T17:48:50.306Z -->
+
+# Como personalizar o fluxo padrão
+
+Updated: 14 de nov de 2025
+
+Este documento fornece uma visão geral das diversas formas de personalizar o fluxo padrão do Cadastro Incorporado, apresentando versões diferentes do fluxo aos seus clientes empresariais.
+
+## Integrar usuários do app WhatsApp Business (também conhecido como “Coexistência”)
+
+Configure o Cadastro Incorporado para [permitir que os clientes empresariais façam a integração usando a conta do app WhatsApp Business e o número de telefone existente:](/documentation/business-messaging/whatsapp/embedded-signup/onboarding-business-app-users)
+
+![](https://scontent-gru1-2.xx.fbcdn.net/v/t39.2365-6/477341352_1809983926468415_3794578338113490554_n.png?_nc_cat=108&ccb=1-7&_nc_sid=e280be&_nc_ohc=-P3Z4_dfNugQ7kNvwHUBsMp&_nc_oc=AdlQPynWj1X9MVV6D3-74b1XS0aiMmW6OXMAOgVQV2R8kKQxqdigKk7KjvV-3maGNcs&_nc_zt=14&_nc_ht=scontent-gru1-2.xx&_nc_gid=wlkcsFMfrXj7t8I_YPpNyg&oh=00_Afk-0OT5oIm-upk7SXaMrcpSHWvfksJcThk78ZnsDMmYbg&oe=69612E1B)
+
+As empresas que forem integradas depois de escolher essa opção poderão usar seu app para enviar mensagens aos clientes em grande escala, mas ainda terão a opção de enviar mensagens individualmente usando o app WhatsApp Business.
+
+## Telas de preenchimento automático
+
+É possível preencher automaticamente várias telas do fluxo padrão do Cadastro Incorporado com os dados comerciais de um cliente. As [telas de preenchimento automático](/documentation/business-messaging/whatsapp/embedded-signup/pre-filled-data) podem reduzir drasticamente a quantidade de informações e interações exigidas dos seus clientes, além de encurtar o fluxo.
+
+![](https://scontent-gru1-2.xx.fbcdn.net/v/t39.2365-6/465727373_1573223883300812_8312998736298536563_n.png?_nc_cat=100&ccb=1-7&_nc_sid=e280be&_nc_ohc=fu48N5EOdVMQ7kNvwGY39t4&_nc_oc=AdnXMCHl_2RHQbNiBFHVIijGcRmnU-TezTzp5m7nN-dvpPQq9DKaAGaZWtbLGeKBsr0&_nc_zt=14&_nc_ht=scontent-gru1-2.xx&_nc_gid=wlkcsFMfrXj7t8I_YPpNyg&oh=00_AflYUsg_CXLlfEEVDaxMbP_zUgJP9H82AaDsk72woCwYIw&oe=69612C47)
+
+## Ignorar a adição e a verificação do número de telefone
+
+É possível personalizar o Cadastro Incorporado para [ignorar completamente as telas de adição e verificação do número de telefone](/documentation/business-messaging/whatsapp/embedded-signup/bypass-phone-addition). Isso pode ser útil se você não quiser que clientes empresariais precisem inserir um número de telefone, receber o código de verificação enviado a esse número e depois confirmar o código.
+
+![](https://scontent-gru2-1.xx.fbcdn.net/v/t39.2365-6/464076811_858112679765152_5952854678961541773_n.png?_nc_cat=107&ccb=1-7&_nc_sid=e280be&_nc_ohc=JKekqEgfu_8Q7kNvwFxLZrw&_nc_oc=Adl9ey0fZDI4FXLPhch7JzRYBUmWrv9ad-xq8J_ne-9MAZrvPyVKPfZbMUEA7cklZ9I&_nc_zt=14&_nc_ht=scontent-gru2-1.xx&_nc_gid=wlkcsFMfrXj7t8I_YPpNyg&oh=00_AfnxLjUxbqHmQfKwaQjvNAu2ddSVDtf7UIKqogdlYBfmXg&oe=6961230E)
+
+![](https://scontent-gru2-2.xx.fbcdn.net/v/t39.2365-6/464106774_850690680604728_8102449662662242044_n.png?_nc_cat=106&ccb=1-7&_nc_sid=e280be&_nc_ohc=9Gw1qfsBfFIQ7kNvwEbBPD-&_nc_oc=AdnTTKLZgZBAjdqITkKuDDYSUDe3D6fJ639I_0pY1dB-vCVl7KNvzggBEWQlKYv6l4Y&_nc_zt=14&_nc_ht=scontent-gru2-2.xx&_nc_gid=wlkcsFMfrXj7t8I_YPpNyg&oh=00_AfnoImLVDzdckrLOuZzlrZlK4L2l-sFF2JZmlUaOc-v3xA&oe=69611287)
+
+## Instalação apenas por app
+
+A [Instalação apenas por app](/documentation/business-messaging/whatsapp/embedded-signup/app-only-install) é uma forma de configurar o Cadastro Incorporado para que apenas tokens comerciais possam ser usados para acessar ativos pertencentes a clientes integrados via fluxo. Isso não afeta o fluxo, apenas quais tokens devem ser usados.
+
+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/parceiros/integracao_de_clientes/cadastro_incorporado/default_flow.md

@@ -0,0 +1,90 @@
+<!-- Source: https://developers.facebook.com/documentation/business-messaging/whatsapp/embedded-signup/default-flow -->
+<!-- Scraped: 2025-12-20T17:48:41.590Z -->
+
+# Fluxo da API de Nuvem
+
+Updated: 11 de nov de 2025
+
+Este documento descreve as telas-padrão exibidas aos clientes da sua empresa conforme navegam pelo fluxo de Cadastro incorporado. Se você injetar [dados pré-preenchidos](/documentation/business-messaging/whatsapp/embedded-signup/pre-filled-data), será possível preencher previamente algumas dessas telas e ignorar outras, o que reduz a probabilidade de erros e facilita a integração dos clientes da sua empresa na plataforma. Este é o fluxo da interface do usuário para a versão 4.
+
+## Telas
+
+### Tela de autenticação
+
+Essa tela faz a autenticação dos clientes empresariais usando as credenciais do Facebook ou do Meta Business Suite.
+
+![](https://scontent-gru1-1.xx.fbcdn.net/v/t39.2365-6/530819633_636229419515187_227138492125594706_n.png?_nc_cat=104&ccb=1-7&_nc_sid=e280be&_nc_ohc=h38WXYUFXkgQ7kNvwF3_Od_&_nc_oc=Adl6zgLKHBZWAioxNvWAYmfN1gmn_ydyiA8qPzvTPzFc_zP0JwpFPYxBlLyPrvpUZTI&_nc_zt=14&_nc_ht=scontent-gru1-1.xx&_nc_gid=WQhOm4wiJG9rS_xyBbS-qg&oh=00_AfkVQf_XSlyNvBf4mdmXRtebsgUBgL0ss-U1RF0gfWxmFw&oe=696124D4)
+
+  
+
+### Tela de autorização
+
+Essa tela descreve os dados que o cliente empresarial permitirá que seu app acesse.
+
+![](https://scontent-gru2-2.xx.fbcdn.net/v/t39.2365-6/531995822_1112262264200439_63249353490863536_n.png?_nc_cat=105&ccb=1-7&_nc_sid=e280be&_nc_ohc=hJsPBhvHLBsQ7kNvwGCf9Np&_nc_oc=AdkYuVkj7j08r6sjdYHf--vRkw27Xl_bt-jOWEozw4tkDPojQRPzCVIfEOCssftytQg&_nc_zt=14&_nc_ht=scontent-gru2-2.xx&_nc_gid=WQhOm4wiJG9rS_xyBbS-qg&oh=00_Afmc0nuZmlX7TAUCjpqQCB2nNQksSJkuPL_z39kgtREvww&oe=69613680)
+
+  
+
+### Tela de seleção de ativos de negócios
+
+Nessa tela, os clientes podem selecionar ativos de negócios existentes, como um portfólio empresarial da Meta e uma conta do WhatsApp Business.
+
+Os usuários também poderão criar novos ativos se não tiverem atingido o limite do portfólio.
+
+![](https://scontent-gru2-2.xx.fbcdn.net/v/t39.2365-6/532045601_1897587967686145_847324094190786110_n.png?_nc_cat=102&ccb=1-7&_nc_sid=e280be&_nc_ohc=mO59PKWUe6sQ7kNvwEYaD1B&_nc_oc=AdnxlRTho3mnsNFF_Rt6Z3qFKesMT2-OIJ3bM_NrbDWqEB07uflrl8crXIHca_6xuUI&_nc_zt=14&_nc_ht=scontent-gru2-2.xx&_nc_gid=WQhOm4wiJG9rS_xyBbS-qg&oh=00_AfkluseNJDxowpMpyqAp9lDJO5oU1v4h0MNAIdcr32ziRA&oe=6961346E)
+
+  
+
+### Tela de criação de ativos de negócios
+
+Nessa tela, os clientes podem selecionar ativos de negócios existentes, como um portfólio empresarial da Meta e uma conta do WhatsApp Business.
+
+Os usuários também poderão criar novos ativos se não tiverem atingido o limite do portfólio.
+
+![](https://scontent-gru2-2.xx.fbcdn.net/v/t39.2365-6/530852550_1105248814823575_6797431386886245236_n.png?_nc_cat=106&ccb=1-7&_nc_sid=e280be&_nc_ohc=XMkzHDOeApEQ7kNvwGpiD_M&_nc_oc=Adk4b6ShfpIDRJQrHpXgXighezzBkb_Q_eN5OW-3WfNoaRzqo9dO-4EgedfzAv6OPAw&_nc_zt=14&_nc_ht=scontent-gru2-2.xx&_nc_gid=WQhOm4wiJG9rS_xyBbS-qg&oh=00_AfnMvkUlW2qalVCPA6qVCZL65ojY5xM-kZsFTtEx4DqiaQ&oe=69613183)
+
+  
+
+### Tela de adição de número de telefone
+
+Nessa tela, o cliente empresarial pode inserir um novo número de telefone comercial para associar à conta do WhatsApp Business.
+
+Ele também pode escolher como deseja receber o código de verificação, que será necessário fornecer na próxima etapa.
+
+Caso você forneça números de telefone aos clientes, será necessário entregar esses códigos ou oferecer números pré-verificados.
+
+![](https://scontent-gru1-2.xx.fbcdn.net/v/t39.2365-6/579214248_1544901606717694_7187028527222587188_n.png?_nc_cat=110&ccb=1-7&_nc_sid=e280be&_nc_ohc=P6QyMk9mVtYQ7kNvwHgE3up&_nc_oc=Adm7gS99uw-VSZ4FbKwnjZVrtXxAHvfYs80MYp_AwwgbwrcEXYUc1ppqbIfd21hPywc&_nc_zt=14&_nc_ht=scontent-gru1-2.xx&_nc_gid=WQhOm4wiJG9rS_xyBbS-qg&oh=00_AfkvR7AHT8ag1VgR8A-RXvWNotAmg1MYIHiuFOEWm4NELA&oe=696110BE)
+
+  
+
+### Tela de verificação do número de telefone
+
+Nessa tela, o cliente empresarial pode verificar a propriedade do número de telefone comercial inserido na etapa anterior.
+
+![](https://scontent-gru1-2.xx.fbcdn.net/v/t39.2365-6/557624038_1991414544970922_7818680630707794930_n.png?_nc_cat=110&ccb=1-7&_nc_sid=e280be&_nc_ohc=pxCujGjgVhwQ7kNvwGJp06M&_nc_oc=Adn8cKtBaexlJ0elx2Xs8pIwiC6wIEd1RGMDA8JwLPwh0HvQi_oLAvyD7Fh5RR0EXCo&_nc_zt=14&_nc_ht=scontent-gru1-2.xx&_nc_gid=WQhOm4wiJG9rS_xyBbS-qg&oh=00_AfkURXo1HqqCjX2z-OEeuLQVsC49E_ZeN7LXNwP3FHLepA&oe=69613060)
+
+  
+
+### Tela de análise de permissões
+
+Essa tela fornece um resumo das permissões que o cliente empresarial concederá ao seu app.
+
+![](https://scontent-gru2-2.xx.fbcdn.net/v/t39.2365-6/530797839_1261352201871305_6011316801343038234_n.png?_nc_cat=105&ccb=1-7&_nc_sid=e280be&_nc_ohc=4eibQ8MevEMQ7kNvwFJc4Av&_nc_oc=AdlI-w8scJn4vC0Hcr2k3oiwS4vPYEERtvH2xTLA-o1zhcH7Y-TGx3GDwNYIX-KCXdM&_nc_zt=14&_nc_ht=scontent-gru2-2.xx&_nc_gid=WQhOm4wiJG9rS_xyBbS-qg&oh=00_AfmeOjrAymcIC1-POI7dJ7uOc7KasLK0wWBo5YqNfdNHNg&oe=69611869)
+
+  
+
+### Tela de sucesso
+
+Essa tela indica que foi possível criar e associar todos os ativos do cliente (portfólio empresarial, WABA, perfil de exibição do número de telefone e número de telefone comercial).
+
+Quando o cliente clicar em Concluir, será disparado um evento de mensagem com a identificação da WABA e do número de telefone comercial do cliente. Use essas informações para integrar o cliente à plataforma.
+
+![](https://scontent-gru2-1.xx.fbcdn.net/v/t39.2365-6/532564823_655188414258906_330922092450163709_n.png?_nc_cat=111&ccb=1-7&_nc_sid=e280be&_nc_ohc=0XvSLpawviUQ7kNvwEq05yx&_nc_oc=AdnR0BU94sgdRNTOdPQBSwC-36hGPClgrDWvOc5B6HrxaGIt5G9dH7ZCQ0eeouZLOhg&_nc_zt=14&_nc_ht=scontent-gru2-1.xx&_nc_gid=WQhOm4wiJG9rS_xyBbS-qg&oh=00_AfmBAYQhhZSpjDv14Ev73TRt9lUyO1---d4tx-cpYiWgGA&oe=69610FEC)
+
+  
+
+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/parceiros/integracao_de_clientes/cadastro_incorporado/errors.md

@@ -0,0 +1,185 @@
+<!-- Source: https://developers.facebook.com/documentation/business-messaging/whatsapp/embedded-signup/errors -->
+<!-- Scraped: 2025-12-20T17:50:57.877Z -->
+
+# Erros no fluxo de Cadastro incorporado
+
+Updated: 10 de nov de 2025
+
+Este guia apresenta os diferentes erros que podem surgir ao [incorporar o fluxo de cadastro](/documentation/business-messaging/whatsapp/embedded-signup/implementation) no seu site ou portal do cliente.
+
+## Telas de fluxo abandonado
+
+Se um cliente empresarial abandonar prematuramente o fluxo de cadastro incorporado, enviaremos um [evento de mensagem](/documentation/business-messaging/whatsapp/embedded-signup/implementation#session-logging-message-event-listener) ao navegador que gerou o fluxo, indicando qual tela o cliente estava visualizando no momento do abandono.
+
+O valor da propriedade `data.current_step` indica qual tela o cliente abandonou:
+
+```
+{
+  data: {
+    current_step: "<CURRENT_STEP>",
+  },
+  type: "WA_EMBEDDED_SIGNUP",
+  event: "CANCEL",
+  version: 3
+}
+```
+
+Valor da etapa atual
+
+Tela correspondente
+
+`<BUSINESS_ACCOUNT_SELECTION>`
+
+[Tela do portfólio empresarial](/documentation/business-messaging/whatsapp/embedded-signup/default-flow#business-portfolio-screen)
+
+`<WABA_PHONE_PROFILE_PICKER>`
+
+[Tela de seleção da WABA](/documentation/business-messaging/whatsapp/embedded-signup/default-flow#business-asset-selection-screen)
+
+`<WHATSAPP_BUSINESS_PROFILE_SETUP>`
+
+[Tela de criação da WABA](/documentation/business-messaging/whatsapp/embedded-signup/default-flow#business-asset-creation-screen)
+
+`<PHONE_NUMBER_SETUP>`
+
+[Tela de adição de número de telefone](/documentation/business-messaging/whatsapp/embedded-signup/default-flow#phone-number-addition-screen)
+
+`<PHONE_NUMBER_VERIFICATION>`
+
+[Tela de verificação do número de telefone](/documentation/business-messaging/whatsapp/embedded-signup/default-flow#phone-number-verification-screen)
+
+`<PERMISSIONS>`
+
+[Tela de análise das permissões](/documentation/business-messaging/whatsapp/embedded-signup/default-flow#permissions-review-screen)
+
+## Erros de criação de conta do Gerenciador de Negócios
+
+Erro
+
+Descrição
+
+**Ocorreu um erro ao processar essa solicitação. Tente novamente mais tarde.**
+
+A criação da conta comercial pode ter falhado por vários motivos. Entre em contato com o Suporte para receber mais ajuda. Solução sugerida: use uma conta ativa do Facebook ou entre em contato com o Suporte para resolver o problema.
+
+**Você atingiu o limite para o número de empresas que pode criar no momento.**
+
+Existe um limite para o número de contas comerciais que você pode criar.
+
+Solução sugerida: use uma conta comercial existente.
+
+**Sua conta do Facebook é muito nova para criar uma conta comercial. Tente novamente em uma hora.**
+
+Novas contas do Facebook precisam esperar algum tempo para criar uma conta do Gerenciador de Negócios. Solução sugerida: use uma conta ativa do Facebook ou espere algumas horas antes de usar a nova conta. A nova conta do Facebook pode ser usada normalmente durante o período de espera.
+
+**Limitamos a frequência com que você pode postar, comentar ou executar outras ações em um determinado período para ajudar a proteger a comunidade contra spam. Tente novamente mais tarde.**
+
+Sua conta do Facebook foi sinalizada devido a um comportamento suspeito. Solução sugerida: use uma conta do Facebook ativa sem problemas anteriores.
+
+**Você não tem mais permissão para usar os produtos do Facebook para anunciar. Você não pode veicular anúncios, gerenciar ativos de publicidade nem criar novos anúncios ou contas comerciais.**
+
+Você não pode criar novas contas do Gerenciador de Negócios devido a um comportamento suspeito anterior. Solução sugerida: use uma conta do Facebook ativa sem problemas anteriores.
+
+**Sua conta de pagamento está desabilitada**
+
+Sua conta de pagamento foi desabilitada devido a um comportamento suspeito anterior.
+
+**Um usuário só pode criar um usuário empresarial de cada vez**
+
+Você só pode criar uma única conta comercial em um determinado período. Solução sugerida: use uma conta empresarial existente para executar a integração.
+
+**O nome escolhido para a empresa não é válido. Considere usar xxx.**
+
+Nome da empresa inválido. Solução sugerida: adicione um nome válido que corresponda ao nome da sua empresa.
+
+## Erros de criação de conta do WhatsApp Business
+
+Erro
+
+Descrição
+
+**Não é possível editar o nome verificado: a verificação do nome já está em andamento.**
+
+Não será permitido editar o nome enquanto a verificação estiver em andamento. Solução sugerida: tente novamente depois que a verificação do nome atual for concluída.
+
+**O usuário não tem permissão para criar contas do WhatsApp Business.**
+
+Você não tem a permissão de nível de administrador necessária para criar contas do WhatsApp na conta comercial selecionada. Solução sugerida: receba acesso de administrador à conta comercial para prosseguir ou selecione uma conta para a qual você tenha permissões de administrador.
+
+**Até que a verificação da empresa e da conta do WhatsApp seja concluída, só é permitido criar um número limitado de contas do WhatsApp Business. Após a verificação, você poderá criar contas adicionais.**
+
+Você tentou criar várias contas do WhatsApp Business em uma empresa não verificada. Solução sugerida: será possível criar contas adicionais do WhatsApp Business somente quando a verificação da empresa e da conta do WhatsApp for concluída. Acesse o Gerenciador de Negócios para começar a verificação da empresa referente à conta.
+
+**Não foi possível verificar a conta empresarial da Meta que você selecionou. Volte à tela anterior para selecionar uma conta diferente ou receba suporte no Gerenciador de Negócios da Meta.**
+
+A conta comercial da Meta selecionada não está em conformidade com as políticas de uso da Plataforma do WhatsApp Business, e não foi possível verificá-la. Solução sugerida: acesse sua conta do Gerenciador de Negócios para saber mais sobre essa conta comercial do Facebook. Se o envio da verificação da sua empresa foi rejeitado, você deve ter recebido uma notificação por email detalhando os motivos. Você pode tentar reenviar a verificação da sua empresa se achar que isso foi um erro ou criar uma conta do WhatsApp Business usando uma conta comercial da Meta que já tenha sido verificada.
+
+**Algo deu errado. Você precisará entrar em contato com o suporte e tentar novamente.**
+
+Esse pode ser um problema intermitente no WhatsApp. Solução sugerida: tente novamente em alguns minutos.
+
+## Erros de configuração de telefone
+
+Erro
+
+Descrição
+
+**O número de telefone foi bloqueado. Verifique o aviso na visão geral do Gerenciador do WhatsApp ou siga as instruções na Página Inicial do Suporte para Empresas.**
+
+Números de telefone bloqueados no WhatsApp não poderão ser adicionados a uma WABA. Solução sugerida: consulte o aviso na visão geral do Gerenciador do WhatsApp ou siga as instruções na [Página Inicial do Suporte para Empresas](https://business.facebook.com/business-support-home) para descobrir o motivo do bloqueio e o que fazer para resolver essa questão. Se você acredita que o telefone foi bloqueado por engano, fale conosco.
+
+**Você atingiu o número máximo permitido de telefones vinculados nesta conta comercial. Para continuar, exclua um número de telefone ou solicite números adicionais. [Saiba mais.](/documentation/business-messaging/whatsapp/business-phone-numbers/phone-numbers)**
+
+No momento, limitamos a quantidade de telefones para todas as criações de contas no WhatsApp Business. Consulte [Números de telefone](/documentation/business-messaging/whatsapp/business-phone-numbers/phone-numbers#register-phone-number) para saber mais sobre esses limites. Solução sugerida: instrua o administrador da empresa da conta do WhatsApp Business a seguir as etapas em Excluir um número de telefone de uma WABA da documentação Números de telefone ou entre em contato com o Suporte Direto para registrar mais de 20 números de telefone nas suas WABAs.
+
+**Esse número de telefone já existe na sua lista de números de telefone.**
+
+Você está tentando adicionar um número de telefone que já existe na sua conta do WhatsApp Business. Solução sugerida: volte para o fluxo ou reinicie-o para selecionar o número de telefone existente.
+
+**Esse número já está registrado em uma conta do WhatsApp. Para usar este número, desconecte-o da conta existente. Depois, volte a esta página e digite o número novamente. Observação: pode levar até 3 minutos para que o número fique disponível.**
+
+O número de telefone já foi cadastrado na nossa plataforma (ou seja, no WhatsApp Messenger, no app WhatsApp Business ou na API do WhatsApp Business). Solução sugerida: [cancele o registro do número](/documentation/business-messaging/whatsapp/solution-providers/support/migrating-phone-numbers-among-solution-partners-via-embedded-signup) se quiser usá-lo ou registre um novo número.
+
+**Seu nome verificado viola as diretrizes do WhatsApp. Edite esse nome e tente novamente.**
+
+O nome usado para o perfil comercial do número de telefone não atende às nossas diretrizes. Solução sugerida: consulte as [diretrizes para nomes de exibição](https://www.facebook.com/business/help/757569725593362) e tente novamente.
+
+**Algo deu errado. Você precisará entrar em contato com o suporte e tentar novamente.**
+
+Ocorreu um problema ao criar o perfil comercial do número de telefone. Solução sugerida: insira novamente o nome correto do perfil comercial de acordo com as [diretrizes](https://www.facebook.com/business/help/757569725593362) e outros detalhes.
+
+## Erros de verificação de telefone
+
+Erro
+
+Descrição
+
+**A propriedade do número de telefone já foi verificada.**
+
+Este número de telefone já foi verificado.
+
+**Não foi possível verificar o código: você tentou registrar o número muitas vezes. Tente novamente mais tarde.**
+
+As APIs do WhatsApp Business permitem um número limitado de tentativas de verificação do número de telefone com senha descartável. Solução sugerida: tente novamente mais tarde.
+
+**O número de telefone não parece válido. Confira o número ou tente novamente após 5 minutos.**
+
+Um número de telefone incorreto foi inserido ou não há suporte para números neste formato. Solução sugerida: verifique se o número está operacional e foi confirmado por uma operadora de telecomunicações. No momento, não damos suporte para números de resposta interativa de voz (IVR).
+
+**Você fez tentativas demais.**
+
+Para evitar spam, o sistema permite apenas um número limitado de tentativas de verificação. Solução sugerida: espere cerca de 12 horas antes de tentar novamente. Após esse período, volte ao fluxo e selecione contas e números de telefone existentes para verificar novamente.
+
+**Ocorreu um erro ao verificar este número de telefone. Tente novamente mais tarde.**
+
+Ocorreu um problema com o código de verificação. Solução sugerida: tente novamente mais tarde.
+
+**Você solicitou o código muitas vezes.**
+
+Para evitar spam, o sistema permite apenas um número limitado de tentativas de verificação. Solução sugerida: limitamos o número de vezes que você pode solicitar um código em determinado período. Volte ao fluxo após o tempo especificado e selecione contas e números de telefone existentes para solicitar um código novamente.
+
+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)