npm - whatsapp-docs-mcp - Versions diffs - 1.0.6 → 1.0.7 - Mend

whatsapp-docs-mcp 1.0.6 → 1.0.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (158) hide show

package/docs/mensagens_de_marketing/implementacao/get_started.md CHANGED Viewed

@@ -1,31 +1,28 @@
 <!-- Source: https://developers.facebook.com/documentation/business-messaging/whatsapp/marketing-messages/get-started -->
-<!-- Scraped: 2025-12-20T17:29:45.783Z -->
+<!-- Scraped: 2026-01-24T00:37:18.360Z -->
-# Começar
+# Primeiros passos
-Updated: 4 de nov de 2025
+Updated: 4 de dez de 2025
-Válido a partir de 1º de julho de 2025: os preços por mensagem já estão em vigor. Além disso, as taxas para mensagens de marketing na API de Nuvem e na API de MM Lite são consistentes, de acordo com as tabelas de tarifas publicadas [aqui](/documentation/business-messaging/whatsapp/pricing).
+A API de Mensagens de Marketing para o WhatsApp (anteriormente conhecida como API de Mensagens de Marketing Lite) agora está disponível para todos.
-Planejamos lançar a MM Lite para o público geral no quarto trimestre de 2025.
-Saiba como enviar um modelo de mensagem com a API de Mensagens de Marketing Lite ("API de MM Lite").
+Saiba como enviar um modelo de mensagem com a API de Mensagens de Marketing para o WhatsApp (MM API para WhatsApp).
 ## Requisitos
--   Você tem uma conta ativa do WhatsApp Business e está em um [país qualificado para a MM Lite](/documentation/business-messaging/whatsapp/marketing-messages/get-started#geographic-availability-of-features).-   Você tem um [modelo de mensagem de marketing](/documentation/business-messaging/whatsapp/templates/marketing-templates) aprovado.-   Você assinou o webhook [mensagens](/documentation/business-messaging/whatsapp/webhooks/reference/messages).
+-   Você tem uma conta ativa do WhatsApp Business e está em um [país qualificado para a API MM para o WhatsApp](/documentation/business-messaging/whatsapp/marketing-messages/get-started#geographic-availability-of-features).-   Você tem um [modelo de mensagem de marketing](/documentation/business-messaging/whatsapp/templates/marketing-templates) aprovado.-   Você assinou o webhook [messages](/documentation/business-messaging/whatsapp/webhooks/reference/messages).
 ## Etapa 1: aceitar os Termos de Serviço
--   Acesse [**Painel de Apps**](https://developers.facebook.com/apps) \\> **WhatsApp** \\> **Início rápido**.-   Localize o módulo "**Aumente o ROI com a API de Mensagens de Marketing Lite**" e clique no botão "**Começar**".-   Clique em "**Continuar para o guia de integração**" e aceite os Termos de Serviço.
+-   Acesse [**Painel de Apps**](https://developers.facebook.com/apps) > **WhatsApp** > **Início rápido**.-   Localize o módulo "**Aumente o ROI com mensagens de marketing com otimizações**" e clique no botão "**Começar**".-   Clique em "**Continuar para o guia de integração**" e aceite os Termos de Serviço.
 ## Etapa 2: enviar uma mensagem de modelo de marketing
 Use o ponto de extremidade `marketing_messages` para enviar uma mensagem de modelo para você mesmo.
 ```
-curl 'https://graph.facebook.com/<API_VERSION>/<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>
-/marketing_messages' \
+curl 'https://graph.facebook.com/<API_VERSION>/<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>/marketing_messages' \
 -H 'Content-Type: application/json' \
 -H 'Authorization: Bearer <ACCESS_TOKEN>' \
 -d
@@ -56,7 +53,7 @@ curl 'https://graph.facebook.com/<API_VERSION>/<WHATSAPP_BUSINESS_PHONE_NUMBER_I
 ## Etapa 3: verificar se a mensagem foi enviada por meio do webhook `status`
-A API de MM Lite aciona [webhooks de status de mensagens](/documentation/business-messaging/whatsapp/webhooks/reference/messages/status) para eventos como enviado, entregue e lido. Quando uma mensagem é enviada por meio da API de MM Lite, a carga do webhook terá `category` e `conversation.origin.type` definidos como `marketing_lite`.
+A API de MM para o WhatsApp aciona [webhooks de status de mensagens](/documentation/business-messaging/whatsapp/webhooks/reference/messages/status) para eventos como enviado, entregue e lido. Quando uma mensagem é enviada por meio da API de MM para o WhatsApp, a carga do webhook terá `category` e `conversation.origin.type` definidos como `marketing_lite`.
 ```
 {
@@ -76,7 +73,7 @@ A API de MM Lite aciona [webhooks de status de mensagens](/documentation/busines
 ## Disponibilidade geográfica dos recursos
-Alguns recursos avançados e funcionalidades de relatórios da API de MM Lite estão disponíveis apenas em regiões específicas, devido a políticas da Meta ou regulamentações locais.
+Alguns recursos avançados e funcionalidades de relatórios da API de MM para o WhatsApp estão disponíveis apenas em regiões específicas, devido a políticas da Meta ou regulamentações locais.
 ### Espaço Econômico Europeu, Reino Unido, Japão, Coreia do Sul
@@ -84,21 +81,20 @@ Alguns recursos avançados e funcionalidades de relatórios da API de MM Lite es
 ### Estados Unidos
--   A partir de 1º de abril de 2025, as mensagens de marketing enviadas a usuários do WhatsApp nos Estados Unidos não serão entregues (código de erro 131049). Essa política não é específica para a API de MM Lite. Ela é válida para todas as APIs de Business Messaging (incluindo a API de Nuvem, [consulte os documentos](/documentation/business-messaging/whatsapp/templates/marketing-templates/per-user-limits)).-   Os números de telefone comerciais nos EUA ainda poderão usar a API de MM Lite para enviar mensagens a usuários fora dos Estados Unidos.
-### Cuba, Irã, Coreia do Norte, Síria e três regiões sancionadas na Ucrânia (Crimeia, Donetsk, Luhansk):
--   As empresas nessas regiões não estão qualificadas para integração, e não é possível enviar mensagens a consumidores que se encontrem nesses lugares. Essa política não é específica para a API de MM Lite. Ela é válida para todas as APIs de Business Messaging (incluindo a API de Nuvem, [consulte os documentos](/documentation/business-messaging/whatsapp/support#country-restrictions))
+-   A partir de 1º de abril de 2025, as mensagens de marketing enviadas a usuários do WhatsApp nos Estados Unidos não serão entregues (código de erro 131049). Essa política não é específica para a API de MM para o WhatsApp. Ela é válida para todas as APIs de Business Messaging (incluindo a API de Nuvem, [consulte os documentos](/documentation/business-messaging/whatsapp/templates/marketing-templates/per-user-limits)).-   Os números de telefone comerciais nos EUA ainda poderão usar a API de MM para o WhatsApp para enviar mensagens a usuários fora dos Estados Unidos.
+    ### Cuba, Irã, Coreia do Norte, Síria e três regiões sancionadas na Ucrânia (Crimeia, Donetsk, Luhansk):
+    -   As empresas nessas regiões não estão qualificadas para integração, e não é possível enviar mensagens a consumidores que se encontrem nesses lugares. Essa política não é específica para a API de MM para o WhatsApp. Ela é válida para todas as APIs de Business Messaging (incluindo a API de Nuvem, [consulte os documentos](/documentation/business-messaging/whatsapp/support#country-restrictions)).
 ### Rússia
-A partir de 20 de junho de 2025, empresas na Rússia poderão usar a API de MM Lite, com exceção dos seguintes recursos:
+A partir de 20 de junho de 2025, empresas na Rússia poderão usar a API de MM para o WhatsApp, com exceção dos seguintes recursos:
--   Mensagens enviadas por empresas que têm um perfil empresarial da Meta na Rússia ou que usam uma forma de pagamento com um endereço russo não receberão otimizações de veiculação.-   As mensagens enviadas de um número de telefone comercial ou para um consumidor nesses países não contarão com relatórios de métricas de clique e conversão. Para as empresas nesses países, as métricas não ficarão disponíveis na interface do usuário do Gerenciador de Anúncios nem na API de Insights. Assim como na API de Nuvem, as métricas continuarão disponíveis por meio da API de Gerenciamento de Negócios e das métricas de conversa da interface do usuário do Gerenciador do WhatsApp.-   Todos os demais recursos da API de MM Lite continuarão disponíveis.
+-   Mensagens enviadas por empresas que têm um perfil empresarial da Meta na Rússia ou que usam uma forma de pagamento com um endereço russo não receberão otimizações de veiculação.-   As mensagens enviadas de um número de telefone comercial ou para um consumidor nesses países não contarão com relatórios de métricas de clique e conversão. Para as empresas nesses países, as métricas não ficarão disponíveis na interface do usuário do Gerenciador de Anúncios nem na API de Insights. Assim como na API de Nuvem, as métricas continuarão disponíveis por meio da API de Gerenciamento de Negócios e das métricas de conversa da interface do usuário do Gerenciador do WhatsApp.-   Todos os demais recursos da API de MM para o WhatsApp continuarão disponíveis.
 ## Saiba mais
--   Saiba mais sobre [otimizações de criativos automatizadas](https://developers.facebook.com/documentation/business-messaging/whatsapp/marketing-messages/automatic-creative-optimization/)-   Conheça outros [formatos de mensagem de marketing](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/marketing-templates)
+-   Conheça outros [formatos de mensagem de marketing](/documentation/business-messaging/whatsapp/templates/marketing-templates)
 Você achou esta página útil?

package/docs/mensagens_de_marketing/implementacao/send_marketing_messages.md CHANGED Viewed

@@ -1,31 +1,29 @@
 <!-- Source: https://developers.facebook.com/documentation/business-messaging/whatsapp/marketing-messages/send-marketing-messages -->
-<!-- Scraped: 2025-12-20T17:29:53.941Z -->
+<!-- Scraped: 2026-01-24T00:38:11.940Z -->
-# Enviar mensagens
+# Como enviar mensagens
-Updated: 14 de nov de 2025
+Updated: 3 de dez de 2025
-Válido a partir de 1º de julho de 2025: os preços por mensagem já estão em vigor. Além disso, as taxas para mensagens de marketing na API de Nuvem e na API de MM Lite são consistentes, de acordo com as tabelas de tarifas publicadas [neste link](/documentation/business-messaging/whatsapp/pricing).
+A API de Mensagens de Marketing para o WhatsApp (anteriormente conhecida como API de Mensagens de Marketing Lite) agora está disponível para todos.
-Planejamos lançar a MM Lite para o público geral no quarto trimestre de 2025.
+Essa API só permite enviar mensagens de modelo de marketing. Para enviar outros tipos e também receber mensagens, você pode usar a API de Nuvem em paralelo com a API de Mensagens de Marketing no mesmo número de telefone comercial.
-A API de MM Lite permite apenas o envio de mensagens de modelo de marketing. Para enviar outros tipos e também receber mensagens, você pode usar a API de Nuvem em paralelo com a API de MM Lite no mesmo número de telefone comercial.
+Caso você use os portais de interface do usuário ou as APIs de um parceiro para configurar e enviar mensagens de marketing, será possível continuar fazendo isso sem precisar usar os recursos abaixo, já que seu parceiro fará a integração com as funções de envio de mensagens da API de MM para o WhatsApp em seu nome.
-Caso você use os portais de interface do usuário ou as APIs de um parceiro para configurar e enviar mensagens de marketing, será possível continuar fazendo isso sem precisar usar os recursos abaixo, já que seu parceiro fará a integração com as funções de envio de mensagens da MM Lite em seu nome.
-## Criar modelos de marketing
+## Como criar modelos de marketing
 Você pode criar modelos de marketing de várias maneiras:
 -   Use a interface do Gerenciador do WhatsApp Business.-   Use o ponto de extremidade "Modelos de mensagem" da API de Gerenciamento do WhatsApp Business.-   Caso você trabalhe com um parceiro, ele poderá oferecer APIs ou interfaces próprias para a criação de modelos, que aproveitam o ponto de extremidade "Modelos de mensagem".
-Veja a documentação sobre como [criar e gerenciar modelos neste link](/documentation/business-messaging/whatsapp/templates/overview).
+Consulte a documentação sobre como [criar e gerenciar modelos](/documentation/business-messaging/whatsapp/templates/overview).
-Após a criação de um modelo de marketing, levará até 10 minutos para que ele seja sincronizado com a conta de anúncios correspondente, permitindo a otimização das mensagens e a mensuração de conversões e cliques. Os modelos que ficarem inativos por mais de sete dias também precisarão de 10 minutos para sincronizar após o novo uso. Após criar novos modelos de marketing (ou enviar a primeira mensagem de marketing em um modelo inativo), aguarde 10 minutos antes de iniciar o envio de tráfego de marketing.
+Após a criação de um modelo de marketing, levará até dez minutos para que ele seja sincronizado com a conta de anúncios correspondente, o que permitirá a otimização das mensagens e a mensuração de conversões e cliques. Os modelos que ficarem inativos por mais de sete dias também precisarão de 10 minutos para sincronizar após o novo uso. Após criar novos modelos de marketing (ou enviar a primeira mensagem de marketing em um modelo inativo), aguarde 10 minutos antes de iniciar o envio de tráfego de marketing.
-A API de MM Lite é compatível com todos os modelos de marketing. Além disso, essa API fornece os seguintes recursos adicionais que não estão disponíveis para modelos de marketing na API de Nuvem:
+A API de Mensagens de Marketing para o WhatsApp é compatível com todos os modelos de marketing. Além disso, essa API fornece os seguintes recursos adicionais que não estão disponíveis para modelos de marketing na API de Nuvem:
--   **Tempo de vida para mensagens de modelo de marketing:** se não conseguirmos entregar uma mensagem a um usuário do WhatsApp, faremos novas tentativas de entrega por um período conhecido como tempo de vida (TTL, pelas iniciais em inglês) ou período de validade da mensagem. O TTL é aplicado a mensagens de modelo de autenticação e utilidade na API de Nuvem. No entanto, para mensagens de modelo de marketing, esse recurso está disponível somente na API de Mensagens de Marketing Lite. Para saber mais sobre a definição de TTLs em mensagens de modelo de marketing, consulte a documentação sobre [como criar e gerenciar modelos via API](/documentation/business-messaging/whatsapp/templates/overview#time-to-live--ttl---customization--defaults--min-max-values--and-compatibility) ou [como definir um período de validade de mensagem personalizado via interface do usuário](https://www.facebook.com/business/help/1305007343713790).
+-   **Tempo de vida para mensagens de modelo de marketing:** se não conseguirmos entregar uma mensagem a um usuário do WhatsApp, faremos novas tentativas de entrega por um período conhecido como tempo de vida (TTL, pelas iniciais em inglês) ou período de validade da mensagem. O TTL é aplicado a mensagens que usam modelos de autenticação e utilidade na API de Nuvem. No entanto, para mensagens que usam modelos de marketing, esse recurso está disponível somente na API de MM para o WhatsApp. Para saber mais sobre a definição de TTLs em mensagens de modelo de marketing, consulte a documentação sobre [como criar e gerenciar modelos via API](/documentation/business-messaging/whatsapp/templates/overview#time-to-live--ttl---customization--defaults--min-max-values--and-compatibility) ou [como definir um período de validade de mensagem personalizado via interface do usuário](https://www.facebook.com/business/help/1305007343713790).
 ## Otimizações automáticas de criativos
@@ -35,63 +33,63 @@ As otimizações automáticas de criativos melhoram o apelo visual e o engajamen
 O recurso testa pequenas variações do seu cabeçalho de imagem, com diferentes orientações de corte ou filtros de cor, e seleciona automaticamente a variante que gera a maior taxa de cliques ao longo do tempo, sem que você precise fazer nenhuma intervenção. Esses aprimoramentos de criativos foram desenvolvidos para ajudar a melhorar o desempenho e o apelo visual das mensagens de marketing, ao mesmo tempo em que preservam a fidelidade da mensagem. As otimizações mencionadas são semelhantes ao [criativo Advantage+](https://www.facebook.com/business/help/297506218282224?id=649869995454285).
-### Corte de imagens
+### Corte de imagem
 Em algumas campanhas, cortaremos de modo automático as imagens de cabeçalho para uma dimensão ideal, garantindo que seus recursos visuais estejam sempre perfeitamente enquadrados, sem cortar o texto da imagem:
-![](https://scontent-gru2-1.xx.fbcdn.net/v/t39.2365-6/490288529_1839136930195624_7868580583654703557_n.png?_nc_cat=111&ccb=1-7&_nc_sid=e280be&_nc_ohc=xC1gplFvOhYQ7kNvwEB2whh&_nc_oc=Adn3_qgu2zthFena3b2DRcdq8iJ9vSEFLzdjsMm-XWpgH0D41JyEZ_pE9HKxsoCbk9E&_nc_zt=14&_nc_ht=scontent-gru2-1.xx&_nc_gid=h2x6DefmdMU7UDS3d_M-Ew&oh=00_AfmldN07iT6k9i451vRFWI2fUEcQAZxvX_3ihlFJvkHWCA&oe=69611F65)
+![](https://scontent-gru2-1.xx.fbcdn.net/v/t39.2365-6/490288529_1839136930195624_7868580583654703557_n.png?_nc_cat=111&ccb=1-7&_nc_sid=e280be&_nc_ohc=CU5c7KKok7QQ7kNvwG9fJ-o&_nc_oc=AdmYjQ9FIRGJ2IFHaTdVFqeSvdddYiIn2bXVR7-eaPXRVxGMqxPKLNnXTLeWHSy2Qkc&_nc_zt=14&_nc_ht=scontent-gru2-1.xx&_nc_gid=7u6hx-c-lcAVtCC0-KxVvg&oh=00_AfqJ-EMhh_E6e9ElYfCCwlco5JblW47_QWxmbn_n0wYnGA&oe=698E62E5)
 ### Filtragem de imagens
 Em algumas campanhas, aplicaremos automaticamente os filtros mais eficazes às imagens de cabeçalho para melhorar a qualidade e o apelo visual:
-![](https://scontent-gru2-1.xx.fbcdn.net/v/t39.2365-6/490148881_649567434578657_6531913133400572045_n.png?_nc_cat=111&ccb=1-7&_nc_sid=e280be&_nc_ohc=dx2dqMMRMdQQ7kNvwE8wn8Z&_nc_oc=Adm0w4ttm7NuvgisHfj5Oy_SDXjHb-DzmqlVWbhsqx8BU8ODpPWHnYR9VnvM9Jv19o4&_nc_zt=14&_nc_ht=scontent-gru2-1.xx&_nc_gid=h2x6DefmdMU7UDS3d_M-Ew&oh=00_Afl8cK5tEW8vIaNN9kgQEEa8ILHbo3xhoSxcEQXqeUtXHg&oe=6961081E)
+![](https://scontent-gru2-1.xx.fbcdn.net/v/t39.2365-6/490148881_649567434578657_6531913133400572045_n.png?_nc_cat=111&ccb=1-7&_nc_sid=e280be&_nc_ohc=z2TcI5sKdZ8Q7kNvwHa5hmF&_nc_oc=AdnWBz6gD7VgclMl7CgnGyr2A1QvheDWGHmuv_eeI4S_L97TlUCYVilk5EUnos5FycU&_nc_zt=14&_nc_ht=scontent-gru2-1.xx&_nc_gid=7u6hx-c-lcAVtCC0-KxVvg&oh=00_AfrVFXIs8VizZVVgn8pzeNU-ed01bXJWLscHnjZimLsnXg&oe=698E4B9E)
-As otimizações automáticas de criativos são executadas de forma silenciosa em todos os cabeçalhos de imagem enviados via API de MM Lite e funcionam para selecionar a imagem de cabeçalho com maior apelo visual e taxa de cliques. É possível desabilitar o recurso via API de Modelos de Mensagem, garantindo às empresas flexibilidade e controle sobre a aplicação dos aprimoramentos de criativos. Veja a chamada da solicitação de API abaixo para saber mais.
+As otimizações automáticas de criativos são executadas de forma silenciosa em todos os cabeçalhos de imagem enviados via API de MM para o WhatsApp e funcionam para selecionar a imagem de cabeçalho com maior apelo visual e taxa de cliques. É possível desabilitar o recurso via API de Modelos de Mensagem, garantindo às empresas flexibilidade e controle sobre a aplicação dos aprimoramentos de criativos. Veja a chamada da solicitação de API abaixo para saber mais.
 ### Sobreposições de texto
 Em algumas campanhas, adicionaremos automaticamente uma sobreposição de texto à sua imagem usando o conteúdo da mensagem:
-![](https://scontent-gru1-2.xx.fbcdn.net/v/t39.2365-6/510250002_997759808891598_7747444436127893252_n.png?_nc_cat=100&ccb=1-7&_nc_sid=e280be&_nc_ohc=MevHA-iyNGsQ7kNvwGK0Q1Y&_nc_oc=AdliXiaU5lRXqAMx61bL35isvJuv8btVqn5mRFrZraJhhskUgEIQp5jETBJQr9qUVHg&_nc_zt=14&_nc_ht=scontent-gru1-2.xx&_nc_gid=h2x6DefmdMU7UDS3d_M-Ew&oh=00_Afm9DucM-QRGe7JoAhoWBRvF3le7sLOJedr2vgI3LQk5lw&oe=69610A65)
+![](https://scontent-gru1-2.xx.fbcdn.net/v/t39.2365-6/510250002_997759808891598_7747444436127893252_n.png?_nc_cat=100&ccb=1-7&_nc_sid=e280be&_nc_ohc=vDQDJ9ibEoEQ7kNvwGAVGHS&_nc_oc=Adl8H5GkrQmQdwNKbQSLEXosTT2ObK8oT-8NMVzkY6cE_vE8ne0XGwjl6XV0O4zsj6s&_nc_zt=14&_nc_ht=scontent-gru1-2.xx&_nc_gid=7u6hx-c-lcAVtCC0-KxVvg&oh=00_AfpYFwr3_n0tJQhK9qeg-Ne0GuFmCnRdKdzmr7hyA1ocqg&oe=698E4DE5)
 ### Animação de imagem
 Em algumas campanhas, transformaremos automaticamente sua imagem de cabeçalho em um GIF animado:
-![](https://scontent-gru1-2.xx.fbcdn.net/v/t39.2365-6/499208944_582725901558956_3362739552469670606_n.png?_nc_cat=108&ccb=1-7&_nc_sid=e280be&_nc_ohc=ZS7O9nNVO5EQ7kNvwFew5m6&_nc_oc=AdmLwr-mVUnCC3JH4LNbZy5uM-Mijc3DOaMvX2aVfVP9xnd3jFtR0W9VRUPiaytmvUI&_nc_zt=14&_nc_ht=scontent-gru1-2.xx&_nc_gid=h2x6DefmdMU7UDS3d_M-Ew&oh=00_AfkqYUmxYraktwHh4861OECc5DGx8mD-hOTp4468SOs0mA&oe=6961317D)
+![](https://scontent-gru1-2.xx.fbcdn.net/v/t39.2365-6/499208944_582725901558956_3362739552469670606_n.png?_nc_cat=108&ccb=1-7&_nc_sid=e280be&_nc_ohc=tvUOVFyofAoQ7kNvwEp8lyn&_nc_oc=Adnf3DrHvgAph4BfiUXPtej4x3tzjeNbP1TrXc91-aiXAKRvuVJm4H3qx-Dkc1hCRAI&_nc_zt=14&_nc_ht=scontent-gru1-2.xx&_nc_gid=7u6hx-c-lcAVtCC0-KxVvg&oh=00_AfoTJXmPk59RyR0MVbdtsK3bH9VgbFUg4YwNE-pIRPqbXA&oe=698E3CBD)
-![](https://scontent-gru1-2.xx.fbcdn.net/v/t39.2365-6/512706297_1012568737452141_3654535789190862417_n.gif?_nc_cat=108&ccb=1-7&_nc_sid=e280be&_nc_ohc=iK1138TgbcIQ7kNvwEB7bnF&_nc_oc=AdkC7UFSkIc3EKdqf4QS26GnGSMXR8w0CGsdfccZxytrinf1fS88aGUM44gdafQuDWc&_nc_zt=14&_nc_ht=scontent-gru1-2.xx&_nc_gid=h2x6DefmdMU7UDS3d_M-Ew&oh=00_Afnw4aQDr7GxCZ4TgguSx2sXzX2O09j9Aw10NEsEBTDm3A&oe=6961065C)
+![](https://scontent-gru1-2.xx.fbcdn.net/v/t39.2365-6/512706297_1012568737452141_3654535789190862417_n.gif?_nc_cat=108&ccb=1-7&_nc_sid=e280be&_nc_ohc=z6W-VtEpj6IQ7kNvwGRkvdF&_nc_oc=AdnlSTVYz6Raj6lOynWWiHe9RnBnwrLSnQXtObz5HfYtsdyqiNcDUjkbf_3cjnBvGms&_nc_zt=14&_nc_ht=scontent-gru1-2.xx&_nc_gid=7u6hx-c-lcAVtCC0-KxVvg&oh=00_Afq88HuZLFabDB_1OrAgO0zwBXdmDnmqjZbqgj-W2roIog&oe=698E49DC)
-### Geração de plano de fundo para a imagem
+### Geração de plano de fundo da imagem
 Em algumas campanhas, geraremos automaticamente um novo plano de fundo para a imagem:
-![](https://scontent-gru1-1.xx.fbcdn.net/v/t39.2365-6/529481192_1905147433612259_8373917617145368846_n.png?_nc_cat=104&ccb=1-7&_nc_sid=e280be&_nc_ohc=Y9A1d_Y8-_IQ7kNvwHz_vma&_nc_oc=Adl01hEqnN-rB-ZEBTPkX3iqglZaVH_4b5eRBdkVyM_NjQgyMq6jY0OKjsMWKoSEN_8&_nc_zt=14&_nc_ht=scontent-gru1-1.xx&_nc_gid=h2x6DefmdMU7UDS3d_M-Ew&oh=00_AfmhTqAXGfCDK6eOPmlDwUw8X4gp4TmtMgtBCOrs8aaT-w&oe=696108C7)
+![](https://scontent-gru1-1.xx.fbcdn.net/v/t39.2365-6/529481192_1905147433612259_8373917617145368846_n.png?_nc_cat=104&ccb=1-7&_nc_sid=e280be&_nc_ohc=usfluoXoH9MQ7kNvwEic5L9&_nc_oc=AdmXljB5pIDFfk8Bi7f8CZXYE6H8FSQpmxD94sjnotBP4AoUqRKyBKLeMS6Aivf7gSY&_nc_zt=14&_nc_ht=scontent-gru1-1.xx&_nc_gid=7u6hx-c-lcAVtCC0-KxVvg&oh=00_Afp_XZm4SKpZ0DVfaD6hT2DujzJSYEuZID6hF_k_CloSSw&oe=698E4C47)
 ### Extração de título
-Em algumas campanhas, extrairemos palavras-chave ou frases da sua mensagem para criar um título para o corpo do texto, buscando destacar informações importantes.
+Em algumas campanhas, extrairemos palavras-chave ou frases da sua mensagem para criar um título para o texto do corpo, buscando destacar informações importantes.
-![](https://scontent-gru2-2.xx.fbcdn.net/v/t39.2365-6/568356332_1741218023258733_764318396409509397_n.png?_nc_cat=102&ccb=1-7&_nc_sid=e280be&_nc_ohc=3m4ruq4Kp5MQ7kNvwFRTgf7&_nc_oc=Adm9x5y9vWlLY9s3Fpaz9A9mbsu66xd4BxpSrkN_s5i9AeKUVrOBA-IVUq3aj_VKKoo&_nc_zt=14&_nc_ht=scontent-gru2-2.xx&_nc_gid=h2x6DefmdMU7UDS3d_M-Ew&oh=00_AfkO7Art-AI-NFPLMy0k0is7Ic1DDiDatzZcXGbalA73Pg&oe=696131B3)
+![](https://scontent-gru2-2.xx.fbcdn.net/v/t39.2365-6/568356332_1741218023258733_764318396409509397_n.png?_nc_cat=102&ccb=1-7&_nc_sid=e280be&_nc_ohc=YBtHfWeYY1IQ7kNvwFiwSdU&_nc_oc=AdnFCZxPptUz0Eg-1nx0Lp0D_srJ6GRlF8rjnPT7_59b3D1ZaucSXLtW5Wziz9haFd4&_nc_zt=14&_nc_ht=scontent-gru2-2.xx&_nc_gid=7u6hx-c-lcAVtCC0-KxVvg&oh=00_AfoTYWX53dKSBqThnXbgaqQIJWNL_c2U6YJKZBnYUENe5Q&oe=698E3CF3)
 ### Extração de título para área de toque
 Em algumas campanhas, extrairemos palavras-chave ou frases da sua mensagem para criar um título para a área de toque, buscando destacar informações importantes.
-![](https://scontent-gru1-2.xx.fbcdn.net/v/t39.2365-6/565927808_1275784957569302_5821755358925562973_n.png?_nc_cat=110&ccb=1-7&_nc_sid=e280be&_nc_ohc=jLFqQ91hp9UQ7kNvwGJFufE&_nc_oc=Adkk7pArjjn27aXBJ0KYbk2cD0XRK-fb6IUSjh1r5MYrNW7BIAX5AyxwAHY_9QqQJkw&_nc_zt=14&_nc_ht=scontent-gru1-2.xx&_nc_gid=h2x6DefmdMU7UDS3d_M-Ew&oh=00_AfkFxjOMWRkIU7ZxeUPfIOkhgb7CwvE5-y1HPV0mP-aBEQ&oe=696123FF)
+![](https://scontent-gru1-2.xx.fbcdn.net/v/t39.2365-6/565927808_1275784957569302_5821755358925562973_n.png?_nc_cat=110&ccb=1-7&_nc_sid=e280be&_nc_ohc=9Rv-DRd8_PgQ7kNvwGTdARi&_nc_oc=Adk-M7gCLGOPDmuQQqRr1w8mS9FOJpPQhZorHja4ixffnLhkbixnj1m_tkN0FPdcfpk&_nc_zt=14&_nc_ht=scontent-gru1-2.xx&_nc_gid=7u6hx-c-lcAVtCC0-KxVvg&oh=00_AfqFue3BI9PQSwUgNt_yVQntaXRFyQ2YbOE3hATZM31PdA&oe=698E677F)
 ### Extensões de produto
-Vamos aprimorar os criativos de imagem única anexando um conjunto de produtos adicionais do catálogo com os quais os usuários possam interagir ou converter, criando experiências mais personalizadas e relevantes.
+Aprimoraremos os criativos de imagem única anexando um conjunto de produtos adicionais do catálogo com os quais os usuários provavelmente interagirão ou converterão, criando experiências mais personalizadas e relevantes.
-![](https://scontent-gru1-2.xx.fbcdn.net/v/t39.2365-6/571739475_802429889249611_5730968219809248185_n.png?_nc_cat=110&ccb=1-7&_nc_sid=e280be&_nc_ohc=mG2y134klnIQ7kNvwG8s2Ra&_nc_oc=Adm7hnSaKInXqoDoqCBDCGBQtOJJbso0ln0k485_so2dK0kZVoPjoFoTPbrTZBHspsg&_nc_zt=14&_nc_ht=scontent-gru1-2.xx&_nc_gid=h2x6DefmdMU7UDS3d_M-Ew&oh=00_AfmgNDQiqHu2E7GzIf9XgZHjfMPMRfv04pghSvDWRedeJA&oe=69613364)
+![](https://scontent-gru1-2.xx.fbcdn.net/v/t39.2365-6/571739475_802429889249611_5730968219809248185_n.png?_nc_cat=110&ccb=1-7&_nc_sid=e280be&_nc_ohc=oaM5Rhvb1XwQ7kNvwEXHBU4&_nc_oc=AdnQhHcwv5f3SCBTxHpzuU8jmn5bXb9Lu0xGKLY-OqucNzWkxFbSWsPF0z-H4RWLCsc&_nc_zt=14&_nc_ht=scontent-gru1-2.xx&_nc_gid=7u6hx-c-lcAVtCC0-KxVvg&oh=00_Afqm41sXNTZrSrrtywinZaVTYgETlhsBB50_DgWhPWo_5w&oe=698E3EA4)
 ### Formatação de texto
 Em algumas campanhas, atualizamos a formatação do texto (por exemplo, removemos espaços desnecessários e frases em negrito) para melhorar o desempenho. O conteúdo do texto não é alterado, apenas o formato.
-![](https://scontent-gru2-2.xx.fbcdn.net/v/t39.2365-6/571559956_1527237245143422_4708127400362964555_n.png?_nc_cat=105&ccb=1-7&_nc_sid=e280be&_nc_ohc=UvNrbKGzDkQQ7kNvwGOXkmv&_nc_oc=AdkEGxDjdpgE-MycREIhRvwq3abJIwz7DF6xNHAZWLqqP2KJTaauLYK7IEZ6OAzVpDw&_nc_zt=14&_nc_ht=scontent-gru2-2.xx&_nc_gid=h2x6DefmdMU7UDS3d_M-Ew&oh=00_AfkkjEI1r15XxdkQMqTdb0FDrV0PXSusLTfOlc1voy-_wg&oe=696125B4)
+![](https://scontent-gru2-2.xx.fbcdn.net/v/t39.2365-6/571559956_1527237245143422_4708127400362964555_n.png?_nc_cat=105&ccb=1-7&_nc_sid=e280be&_nc_ohc=piCa-rBvft0Q7kNvwHob_Vc&_nc_oc=Adn7dIZSXmL3im_c4vFM5MNlJUWCBN01kQG2eNzmCiMo8sE6w5Tlz2g9DLKQALEWxGQ&_nc_zt=14&_nc_ht=scontent-gru2-2.xx&_nc_gid=7u6hx-c-lcAVtCC0-KxVvg&oh=00_Afp-_kp0M9wYgBcRKlZ9VQJv-vHYPsdZPSERcHCW01kNBQ&oe=698E6934)
 ### Configurar otimizações automáticas de criativos (nível do modelo)
@@ -99,7 +97,6 @@ Todos os recursos de otimização são habilitados por padrão, mas você pode u
 ```
 POST /<WHATSAPP_BUSINESS_ACCOUNT_ID>/message_templates
 {
   "name": "<TEMPLATE_NAME>",
   "language": "<TEMPLATE_LANGUAGE_AND_LOCALE_CODE>",
@@ -130,7 +127,7 @@ POST /<WHATSAPP_BUSINESS_ACCOUNT_ID>/message_templates
       "product_extensions": {
         "enroll_status": "OPT_OUT"
       },
-      "text_formating_optimization": {
+      "text_formatting_optimization": {
         "enroll_status": "OPT_OUT"
       }
     }
@@ -138,9 +135,9 @@ POST /<WHATSAPP_BUSINESS_ACCOUNT_ID>/message_templates
 }
 ```
-### Configurar otimizações automáticas de criativos (no nível da conta do WhatsApp Business)
+### Configurar otimizações automáticas de criativos (nível da conta do WhatsApp Business)
-Todos os recursos de otimização são habilitados por padrão, mas você pode usar o objeto creative\_features\_spec para especificar quais otimizações ativar ou desativar na conta do WhatsApp Business. Para isso, defina a propriedade enroll\_status de cada otimização que você quer modificar como OPT\_IN ou OPT\_OUT. Por exemplo:
+Todos os recursos de otimização são habilitados por padrão, mas você pode usar o objeto creative\_features\_spec para especificar quais otimizações ativar ou desativar para a conta inteira do WhatsApp Business. Para isso, defina a propriedade enroll\_status de cada otimização que você quer modificar como OPT\_IN ou OPT\_OUT. Por exemplo:
 ```
 POST /<WHATSAPP_BUSINESS_ACCOUNT_ID>
@@ -171,7 +168,7 @@ POST /<WHATSAPP_BUSINESS_ACCOUNT_ID>
       "text_extraction_for_tap_target": {
         "enroll_status": "OPT_IN"
       },
-      "text_formating_optimization": {
+      "text_formatting_optimization": {
         "enroll_status": "OPT_OUT"
       }
     }
@@ -179,15 +176,23 @@ POST /<WHATSAPP_BUSINESS_ACCOUNT_ID>
 }
 ```
-## Enviar mensagens de modelo de marketing
+## Outras otimizações
+### Truncamento de texto
+Truncaremos o texto em um número de linha específico para aumentar o desempenho. Nenhum contexto do texto é alterado, e o texto original ainda pode ser acessado por meio do botão "Ler mais". As regras exatas para truncamento de número de linhas são as seguintes:
-A MM Lite não é compatível com empresas de MSC. As solicitações [`marketing_messages`](/documentation/business-messaging/whatsapp/marketing-messages/send-marketing-messages#send-marketing-template-messages) serão encaminhadas via API de Nuvem ou rejeitadas se o campo `product_policy` estiver definido como strict.
+-   **Mensagens sem CTA, mas com um link no corpo** (substitui as regras abaixo): truncadas em 5 linhas-   **Mensagens com cabeçalho de mídia** ([Imagem](/documentation/business-messaging/whatsapp/messages/image-messages), [Vídeo](/documentation/business-messaging/whatsapp/messages/video-messages), [Documento](/documentation/business-messaging/whatsapp/messages/document-messages), [Localização](/documentation/business-messaging/whatsapp/messages/template-messages#location) e [GIF](/documentation/business-messaging/whatsapp/templates/components#media-header)): truncadas em 3 linhas-   **Mensagens sem cabeçalho** (ou seja, [mensagens de texto](/documentation/business-messaging/whatsapp/messages/template-messages#text-based)): truncadas em 4 linhas
+## Como enviar mensagens de modelo de marketing
+A API de Mensagens de Marketing para o WhatsApp não é compatível com empresas de MSC. As solicitações `/marketing_messages` serão encaminhadas pela API de Nuvem ou rejeitadas se o campo `product_policy` estiver definido como strict.
 O envio de mensagens segue a mesma sintaxe de carga da API usada para enviar mensagens na API de Nuvem e exige as mesmas permissões.
-O ponto de extremidade `/marketing_messages` é compatível **apenas** com mensagens de modelo de marketing para a API de Nuvem e a API de MM Lite. Todos os outros tipos de mensagem (formato livre, autenticação, serviço, utilidade) não são aceitos e resultarão em erro.
+O ponto de extremidade `/marketing_messages` aceita **apenas** mensagens de modelo de marketing para a API de MM para o WhatsApp e a API de Nuvem. Todos os outros tipos de mensagem (formato livre, autenticação, serviço, utilidade) não são aceitos e resultarão em erro.
-As mensagens de marketing serão enviadas apenas pela MM Lite quando o cliente empresarial tiver atendido a todos os [requisitos de integração](/documentation/business-messaging/whatsapp/marketing-messages/onboarding). Se os requisitos de integração não forem atendidos, as mensagens de marketing ainda serão encaminhadas pela API de Nuvem. Para desabilitar a opção de direcionar para a API de Nuvem, defina o campo opcional `product_policy` como "strict".
+As mensagens de marketing só serão enviadas pela API de MM para o WhatsApp quando o cliente empresarial tiver atendido a todos os [requisitos de integração](/docs/whatsapp/marketing-messages-lite-api/onboarding). Se os requisitos de integração não forem atendidos, as mensagens de marketing ainda serão encaminhadas pela API de Nuvem. Para desabilitar a opção de direcionar para a API de Nuvem, defina o campo opcional `product_policy` como "strict".
 Observação: você ainda poderá usar o ponto de extremidade `/messages` para enviar mensagens de marketing usando a API de Nuvem.
@@ -205,7 +210,6 @@ Os parceiros de troca de mensagens empresariais precisam se autenticar usando um
 ```
 POST /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>/marketing_messages
 {
   "messaging_product": "whatsapp",
   "recipient_type": "individual",
@@ -214,22 +218,23 @@ POST /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>/marketing_messages
   "<MESSAGE_TYPE>": {
     <MESSAGE_CONTENTS>
   },
   <!-- Optional -->
   "product_policy": "<PRODUCT_POLICY>",
   "message_activity_sharing": <SHARE_MESSAGING_ACTIVITY?>
 }
 ```
-A API de MM Lite oferece os recursos adicionais a seguir que não estão disponíveis para mensagens de modelo de marketing na API de Nuvem:
+A API de MM para o WhatsApp oferece os recursos adicionais a seguir que não estão disponíveis para mensagens de modelo de marketing na API de Nuvem:
--   **Política de fallback de produto:** defina `product_policy` como `CLOUD_API_FALLBACK` para que a API envie a mensagem por meio da API de Nuvem se os [requisitos de integração](/documentation/business-messaging/whatsapp/marketing-messages/onboarding) não tiverem sido atendidos. Defina como `STRICT` se não quiser que a API envie a mensagem via API de Nuvem quando não houver conexão com o WhatsApp.-   **Compartilhamento de atividades de mensagens:**`message_activity_sharing` é um parâmetro opcional no nível da mensagem que ativa/desativa o compartilhamento de atividades de mensagens com a Meta (por exemplo, leitura da mensagem) para ajudar a otimizar as mensagens de marketing. Se o parâmetro não for fornecido, será aplicada a configuração padrão no nível da Conta do WhatsApp Business. Sempre que quiser, você pode editar sua configuração padrão nas configurações do negócio (consulte o registro de alterações para ver uma captura de tela).
+-   **Política de fallback de produto:** defina `product_policy` como `CLOUD_API_FALLBACK` para que a API envie a mensagem pela API de Nuvem se os [requisitos de integração](/docs/whatsapp/marketing-messages-lite-api/onboarding) não tiverem sido atendidos. Defina como `STRICT` se não quiser que a API envie a mensagem pela API de Nuvem como fallback.
+    -   **Compartilhamento de atividades de mensagens:**`message_activity_sharing` é um parâmetro opcional no nível da mensagem que ativa ou desativa o compartilhamento de atividades de mensagens com a Meta (por exemplo, leitura da mensagem) para ajudar a otimizar as mensagens de marketing. Se o parâmetro não for fornecido, será aplicada a configuração padrão no nível da conta do WhatsApp Business. Sempre que quiser, você pode editar sua configuração padrão nas configurações do negócio (consulte o registro de alterações para encontrar uma captura de tela).
-Para saber mais, leia a documentação da API de Nuvem sobre [tipos de mensagem](/documentation/business-messaging/whatsapp/messages/send-messages#message-types), já que a API de MM Lite usa a mesma formatação de envio.
+Para saber mais, leia a documentação da API de Nuvem sobre [tipos de mensagem](/documentation/business-messaging/whatsapp/messages/send-messages#message-types), já que a API de MM para o WhatsApp usa a mesma formatação de envio.
 ## Como receber webhooks de status da mensagem
-A API de MM Lite dispara webhooks de status da [mensagem](/documentation/business-messaging/whatsapp/webhooks/reference/messages/status) (enviada, entregue e lida). Além disso, esses webhooks que descrevem a mensagem enviada via API de MM Lite e incluem informações de preços terão `pricing.category` e `conversation.type` definidos como `marketing_lite`. Se a mensagem for direcionada pela API de Nuvem, `pricing.category` será definido como `marketing`.
+A API de MM para o WhatsApp dispara webhooks de status da [mensagem](/documentation/business-messaging/whatsapp/webhooks/reference/messages/status) (enviada, entregue, lida). Além disso, esses webhooks que descrevem a mensagem enviada pela API de MM para o WhatsApp e incluem informações de preços terão `pricing.category` e `conversation.type` definidos como `marketing_lite`. Se a mensagem for direcionada pela API de Nuvem, `pricing.category` será definido como `marketing`.
 ```
 {
@@ -247,11 +252,11 @@ A API de MM Lite dispara webhooks de status da [mensagem](/documentation/busines
 }
 ```
-Recomendamos que você mantenha registros dos IDs de cada mensagem enviada, bem como de qual API foi utilizada para o envio (Nuvem ou MM Lite). Assim, será possível usar o ID único da mensagem, retornado nos webhooks de status, para identificar a origem da mensagem enviada.
+Recomendamos que você mantenha registros dos IDs de cada mensagem enviada, bem como de qual API foi utilizada para o envio (Nuvem ou MM). Assim, será possível usar o ID único da mensagem, retornado nos webhooks de status, para identificar a origem da mensagem enviada.
 ## Como receber mensagens
-A MM Lite é uma API apenas de envio. Ela não processa mensagens recebidas de consumidores. Para receber mensagens em um telefone comercial, use a API de Nuvem em paralelo com a API de MM Lite no mesmo número.
+A MM para o WhatsApp é uma API apenas de envio. Ela não processa mensagens recebidas de consumidores. Para receber mensagens em um número de telefone comercial, use a API de Nuvem em paralelo com a API de MM para WhatsApp no mesmo número.
 Você achou esta página útil?

package/docs/mensagens_de_marketing/measure_conversion.md ADDED Viewed

@@ -0,0 +1,132 @@
+<!-- Source: https://developers.facebook.com/documentation/business-messaging/whatsapp/marketing-messages/measure-conversion -->
+<!-- Scraped: 2026-01-24T00:37:28.097Z -->
+# Configurar a mensuração de conversão
+Updated: 14 de nov de 2025
+Válido a partir de 1º de julho de 2025: os preços por mensagem já estão em vigor. Além disso, as taxas para mensagens de marketing na API de Nuvem e na API de MM Lite são consistentes, de acordo com as tabelas de tarifas publicadas [neste link](/documentation/business-messaging/whatsapp/pricing).
+Planejamos lançar a MM Lite para o público geral no quarto trimestre de 2025.
+Com a API de MM Lite, agora você pode fazer a integração das mensagens de marketing com eventos, o que permite mensurar a taxa e o custo para que uma mensagem de marketing enviada pela API de MM Lite leve a eventos da parte inferior do funil (como compras) no site ou app.
+A mensuração de conversões tem como base os mesmos eventos que você pode enviar à Meta ao usar anúncios. Assim, as empresas que já têm integração com eventos para fins de anúncios (por exemplo, via Pixel ou API de Conversões para sites ou SDK da Meta no app para celular) podem aproveitar com mais facilidade os mesmos relatórios gerados automaticamente, sem precisar de configuração.
+Se uma empresa estiver usando mensagens de marketing na MM Lite e campanhas de anúncios no mesmo portfólio empresarial, os eventos de conversão relatados serão automaticamente atribuídos ao último toque da Meta (clique na mensagem de marketing ou no anúncio) antes do evento, com base nas configurações da janela de atribuição de cada um. Por exemplo, se uma empresa estiver veiculando uma campanha de anúncios no Instagram e uma campanha de mensagens de marketing na MM Lite, cada uma com um URL direcionando ao mesmo site para vendas, e o usuário fizer a compra depois de clicar no anúncio do Instagram e na mensagem de marketing, esse evento será atribuído ao clique na mensagem de marketing ou ao clique no anúncio, com base nas configurações da janela de atribuição de cada um. Assim, as empresas conseguem entender melhor o panorama geral das campanhas de anúncios e mensagens de marketing na geração de resultados.
+## Entender as entidades de anúncios vinculadas
+Quando uma empresa se cadastra na API de MM Lite, contas de anúncios somente para leitura são criadas no portfólio empresarial e sincronizadas com cada conta do WhatsApp Business do mesmo portfólio. As mensagens de marketing fazem parte de um recurso separado e diferentes dos anúncios. O uso do termo “anúncios” abaixo representa entidades de anúncios apenas como construções técnicas.
+Nenhuma ação é necessária por parte da empresa ou do parceiro. As contas de anúncios somente para leitura vinculadas ficam sincronizadas com as mudanças feitas nos modelos de marketing. Assim, os modelos de marketing novos ou atualizados são refletidos na entidade de anúncio vinculada.
+Há vários benefícios em vincular modelos de marketing a contas de anúncios:
+**Interface do usuário e API comuns para equipes de marketing:** as empresas podem ver as campanhas de marketing e as métricas de campanha da API de MM Lite como "Campanhas" na aba "Mensagens de marketing" do Gerenciador de Anúncios e via API usando a "[API de Insights](/docs/marketing-api/insights)" de Marketing. Essas interfaces ajudam as equipes de marketing a visualizar as campanhas de anúncios e mensagens de marketing usando recursos e terminologia comuns, em vez de visualizar as campanhas de anúncios em um lugar e as campanhas de marketing enviadas via WhatsApp em outro.
+-   **Novas métricas:** a interface do usuário do Gerenciador de Anúncios e a API de Insights relatam novas métricas de conversão (por exemplo, web, app) que não são compatíveis com a API de Nuvem e a API de Gerenciamento do WhatsApp Business. Quando as mensagens de modelo de marketing enviadas por meio da API de MM Lite levam a eventos de conversão (por exemplo, adição ao carrinho, compra) que uma empresa relata no próprio site ou app, esses eventos são atribuídos à mensagem de marketing e exibidos em métricas, o que permite uma melhor compreensão do ROI das mensagens de marketing. Os eventos são reportados por meio da integração com o Pixel ou a API de Conversões para eventos da web e de apps, bem como o SDK da Meta.
+## Diretrizes de sincronização entre modelo e anúncio
+-   Durante a integração inicial com a API de MM Lite, os modelos de marketing são direcionados aos anúncios apenas uma vez.-   Para que os modelos exibam as métricas de conversão do app corretas, as sincronizações devem ser concluídas.-   A sincronização dos anúncios pode levar até 10 minutos.-   Evite enviar mensagens com novos modelos antes que a sincronização seja concluída, para evitar erros ou perdas de otimização e rastreamento.-   As métricas de conversão não estarão habilitadas para modelos existentes antes da integração inicial.-   Para reativar modelos não utilizados por mais de 7 dias, envie uma mensagem usando o modelo e aguarde 10 minutos para que ele seja reativado pela sincronização do anúncio.
+![](https://scontent-gru2-1.xx.fbcdn.net/v/t39.2365-6/476235279_4018761408406419_4409302645887282875_n.png?_nc_cat=107&ccb=1-7&_nc_sid=e280be&_nc_ohc=h-l-S1vDr6wQ7kNvwGzZACs&_nc_oc=AdkjV1vZmZLAsqGkqhyMz-VJoXk_7eGjeaZcvPKxULFXyCQ1JZQcDiH37fN4T5Yt8RA&_nc_zt=14&_nc_ht=scontent-gru2-1.xx&_nc_gid=gqx4FPNsLsCUzQ4BdjsSqQ&oh=00_AfqYxmGESnWft4bdUsLIAUFyR9LO_0F3s_D2FKrKzPBtcw&oe=698E3D0B)
+## Entender a configuração automática de objetivos
+Para mensurar eventos de conversão, a API de MM Lite sincroniza automaticamente modelos de marketing com entidades de anúncios correspondentes (campanhas, conjuntos de mensagens e anúncios), com configurações que permitem gerar relatórios de conversão de objetivos presumidos.
+Para reduzir a complexidade da integração da MM Lite para as empresas, esse processo acontece automaticamente. Para pessoas familiarizadas com o ecossistema de anúncios da Meta, é possível observar que esses parâmetros de campanha e conjunto de anúncios não mudam a maneira como as mensagens são veiculadas pela API de MM Lite. Eles são definidos apenas para que os eventos relatados possam ser atribuídos corretamente.
+Consulte a tabela abaixo para entender como os modelos de marketing são direcionados a entidades de anúncios.
+Parâmetros da campanha
+Parâmetros do conjunto de mensagens
+Modelos de marketing sem botão de CTA para URL
+Objective:OUTCOME\_SALES
+OptimizationGoal: Impression
+Modelos de marketing com um botão de CTA para URL que direciona a um site ou app sem ativar os relatórios de eventos.`*`
+Objective:LINK\_CLICKS
+OptimizationGoal: LinkClicks
+Modelos de marketing com um botão de CTA para URL que direciona a um site ou app com os relatórios de eventos ativados.`*`
+Objective:LINK\_CLICKS
+OptimizationGoal: OffsiteConversion
+`*` Os relatórios de eventos são detectados quando o URL direciona a um site ou app que a mesma BMID ativou para relatórios de eventos via Pixel, API de Conversões ou SDK da Meta.
+Embora a maioria das mudanças nos Modelos seja sincronizada automaticamente com os Anúncios (por exemplo, conteúdo de texto), os parâmetros de Mensagem e Campanha são sincronizados apenas uma vez quando a empresa faz a integração inicial com a MM Lite ou cria um novo Modelo. O objetivo é manter uma estrutura consistente de campanha e conjunto de mensagens ao relatar cliques e conversões de mensagens enviadas usando esse Modelo. Assim, se você quiser adicionar, editar ou remover um URL de um botão de CTA em um modelo, será necessário criar um novo modelo para capturar corretamente as métricas de clique e conversão do URL atualizado.
+## Conferir se o URL é compatível com a mensuração de conversões
+Para atribuir os eventos relatados via Pixel da Meta, API de Conversões para eventos da web ou do app ou SDK da Meta, antes do envio, a Meta anexará uma identificação de clique aos URLs enviados em botões de CTA nas mensagens de modelo de marketing.
+Caso você ou o parceiro com quem trabalha use um serviço de link curto que também tenta reformatar URLs, um erro poderá ser gerado.
+Por exemplo:
+-   Você envia o URL `www.mybusiness.com`.-   Seu parceiro reformata o URL para `www.partnerURL.com/abc123` antes de enviá-lo à API de MM Lite.-   A API de MM Lite reformata o URL para `www.partnerURL.com/abc123?fbclid=yxz789`. Nesse caso, o serviço de URL curto do seu parceiro poderá impedir que a Meta anexe a identificação do clique.
+Faça testes para garantir que os URLs sejam transmitidos corretamente e que você consegue encontrar as métricas corretas de eventos de conversão no Gerenciador de Anúncios ou na API de Insights antes de executar as cargas de trabalho de produção. Caso enfrente problemas decorrentes desse comportamento, fale com seu parceiro ou entre em contato diretamente com a Meta para mais informações.
+## Mensurar conversões no site com o Pixel da Meta ou a API de Conversões
+As empresas que geram relatórios de eventos do site usando o Pixel da Meta ou a API de Conversões para web agora podem mensurar quando o clique em um URL na mensagem de marketing enviada pela API de MM Lite leva a um dos três eventos de conversão.
+Se a empresa ainda não estiver gerando relatórios de eventos de conversão fora do site a partir do próprio site, consulte a documentação abaixo para configurar os relatórios de eventos:
+**Tutorial**: [Começar a usar o Pixel da Meta e a API de Conversões](https://l.facebook.com/l.php?u=https%3A%2F%2Fwww.facebookblueprint.com%2Fstudent%2Factivity%2F212737&h=AT3UBqS85L_wRY_JL07MUO37dOBACvOB7VDpXg8rNLjA3IhJ_mESHtg2T3DGsXXQkHx8iDYreRmgdJiK2dUbE29NnL5UAZV_W_Rslal0UCfmNll0Zzv51OQh6ga-MinEbljBvyzL_moExcZ8qDbP9dhAMbE)
+Quando a empresa gera relatórios de eventos via Pixel ou API de Conversões, os três eventos padrão a seguir são automaticamente associados a visitantes que chegam ao site a partir de um CTA para URL de uma mensagem de marketing enviada pela API de MM Lite:
+-   Adicionar ao carrinho-   Iniciar finalização da compra-   Compra-   Valor da compra
+Quando um usuário clica em um CTA para URL de uma mensagem da API de MM Lite e realiza qualquer um dos três eventos acima, a Meta atribui automaticamente o evento de conversão à campanha da MM Lite e disponibiliza essas análises para você ou seu parceiro pela API de Insights. Seu parceiro poderá conferir essas análises nas plataformas de relatórios que você costuma usar.
+Se esse evento de conversão também estiver sendo usado para mensurar a eficácia dos anúncios no Facebook ou no Instagram, a Meta atribuirá a conversão ao último toque do usuário. Por exemplo, se um usuário chegar ao site por um anúncio no Facebook, fechar a janela do navegador e, mais tarde, retornar ao site clicando em um link de uma mensagem da API de MM Lite e comprar um item, esse evento de conversão de compra será atribuído à campanha da API de MM Lite (e não ao anúncio no Facebook), já que essa é a interação mais recente.
+## Mensurar conversões do app com o SDK da Meta ou a API de Conversões
+As empresas podem usar a API de MM Lite para mensurar quando as mensagens de marketing levam usuários a realizar eventos no app, como compras e ativações do app. Consulte [API de Conversões para eventos do app](/docs/marketing-api/conversions-api/app-events) para saber mais sobre eventos do app.
+Os seguintes eventos de conversão do app estão disponíveis para a API de MM Lite:
+-   Compra do app-   Valor da compra no app-   Adição ao carrinho no app-   Finalização da compra iniciada no app-   Ativações no app
+As empresas podem capturar eventos de conversão do app de três maneiras. Para mais informações, consulte [API de Conversões para eventos do app](/docs/marketing-api/conversions-api/app-events).
+-   Pelo SDK da Meta-   Pela API de Conversões-   Por um Parceiro de Métricas para Aplicativos, que envia eventos à Meta em seu nome
+### Como usar o SDK da Meta
+-   Caso seu app esteja usando o SDK da Meta, [atualize](/docs/android/upgrading-4x) a versão do SDK para a versão 17.0.2 ou posterior do Android SDK da Meta. No momento, a mensuração de apps não está disponível no iOS.-   Caso o app use um Parceiro de Métricas para Aplicativos (MMP, pelas iniciais em inglês) compatível, consulte o seu MMP para preparar o app.-   Caso seu app esteja usando a API de Conversões, clique [neste link](/docs/marketing-api/conversions-api/parameters/app-data#campaign-ids) para saber mais sobre como enviar parâmetros campaign\_ids com eventos do app.0 Para obter campaign\_ids, será necessário analisar os `campaign_ids` de `al_applink_data parameters` do deep link em que o usuário clicou.
+Exemplo de deep link:
+```
+exampleapp://applink/ad_landing_recommend?data={"goods_id":"39109246","page_type":"B"}&al_applink_data={"target_url":"https://www.exampleapp.com&fbclid=IwZXh0bgNhZW0BMAABHbKVD62Fa0uTdpAh6KZn16BmrnWgsTbZgiCEsKGLOcF9RDncEAsbJKWp0Q_aem_y0zBYthdxb0j9epvkZum7w","extras":{"fb_app_id":312563225523989},"referer_app_link":{"url":"fb:\/\/\/?app_id=312563225523989","app_name":"Facebook"},"campaign_ids":"IwAR2rBBgtFjvI_IUUes4nZ6FcQ0dtqujIz1w9JIwrs1YKKn7tGIIqC4kKrXk_wapm_fVVosPGBQJWpvSW8Z8emXg_aem_pyDxR3ch5qDkVdd0Y138yg","ad_id":"1234567","adgroup_id":"1234567","campaign_id":"1234567","campaign_group_id":"1234567","account_id":"1234567"}
+```
+-   Verifique se você também configurou o pixel/conversões para o URL alternativo do site.
+### Por um Parceiro de Métricas para Aplicativos
+Algumas plataformas de mensuração de apps encaminham automaticamente eventos de conversão do app para a Meta em seu nome. Nenhuma ação é necessária da sua parte.
+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)