DocumentaçãoExperience PlatformGuia dos conectores de origem

[Beta]{class="badge informative"}

WhatsApp

Última atualização: 29 de outubro de 2026

Criado para:

  • Desenvolvedor
NOTE
A origem WhatsApp está na versão beta. Leia a Visão geral das fontes para obter mais informações sobre o uso de conectores rotulados com beta.
IMPORTANT
Essa fonte está em beta privado e disponível para um número limitado de clientes. Entre em contato com seu representante da Adobe para solicitar acesso.

A Adobe Experience Platform permite a assimilação de dados de fontes externas, além de permitir estruturar, rotular e aprimorar os dados recebidos por meio dos serviços da Experience Platform. Você pode assimilar dados de várias fontes, como aplicativos da Adobe, armazenamento baseado em nuvem, bancos de dados e muitas outras.

O Experience Platform oferece suporte para assimilação de dados de aplicativos de transmissão contínua. O suporte para provedores de mensagens inclui WhatsApp.

O WhatsApp Business é uma plataforma de mensagens que as empresas usam para se comunicar com clientes por mais de WhatsApp. A origem WhatsApp transmite mensagens de entrada que seus clientes enviam para seu número de telefone WhatsApp Business para a Experience Platform em tempo quase real.

O Meta entrega cada mensagem a um endpoint de transmissão da Platform (um webhook), onde ela é capturada como um registro bruto de Evento de experiência e adicionada a um conjunto de dados no data lake para uso downstream. O conector assimila a carga bruta do webhook como está, portanto, cada tipo de mensagem WhatsApp é preservado.

Como o conector funciona how-it-works

A origem WhatsApp segue esta sequência para trazer uma mensagem para a Experience Platform:

  1. Um cliente envia uma mensagem para seu número de telefone WhatsApp Business.
  2. O Meta assina a carga do webhook com o Segredo do aplicativo (X-Hub-Signature-256) e a envia para a URL de retorno de chamada que você configurou no ponto de extremidade de streaming da Platform.
  3. A Platform valida a assinatura, captura a carga bruta como um Evento de experiência e a adiciona ao seu conjunto de dados WhatsApp.

Pré-requisitos prerequisites

Antes de criar uma conexão de origem WhatsApp, conclua o seguinte no Meta em developers.facebook.com:

  • Crie um aplicativo Meta do tipo Negócio e adicione o produto WhatsApp a ele.
  • Crie uma Conta Comercial WhatsApp (WABA) com um número de telefone registrado.
  • Verifique se o aplicativo tem as permissões whatsapp_business_management e whatsapp_business_messaging.
  • Em Configurações do Aplicativo > Básico, copie o Segredo do Aplicativo. O Meta usa o App Secret para assinar cargas de webhook.
  • Escolha um token de verificação. Pode ser qualquer sequência e é um segredo compartilhado inserido na Platform e no Meta.

A tabela a seguir descreve onde encontrar cada credencial e para que é usada.

Credencial
Onde obter
Usado para
Segredo do aplicativo
Meta > Configurações do aplicativo > Básico
Validando a assinatura X-Hub-Signature-256 em cada webhook de entrada.
Verificar token
Você escolhe
O handshake de verificação única entre o Meta e a Platform.

Inscreva seu aplicativo no WABA subscribe-app

Inscreva seu aplicativo Meta na conta de negócios do WhatsApp para que o Meta direcione os eventos do WABA para seu aplicativo. Essa etapa é necessária e ocorre totalmente no Meta, mas a entrega só começa após você configurar a URL de retorno de chamada. Consulte Conectar Negócios do WhatsApp ao Experience Platform.

IMPORTANT
Se você ignorar essa etapa, as mensagens nunca serão entregues e nenhum erro será exibido na Platform. Uma assinatura WABA ausente é a causa mais comum de problemas de "nenhum dado assimilado". Consulte Solução de problemas.

Assine seu aplicativo usando a API gráfica:

POST https://graph.facebook.com/{VERSION}/{WHATSAPP_BUSINESS_ACCOUNT_ID}/subscribed_apps

Verifique a assinatura com:

GET https://graph.facebook.com/{VERSION}/{WHATSAPP_BUSINESS_ACCOUNT_ID}/subscribed_apps

Ambas as chamadas exigem um token com a permissão whatsapp_business_management e acesso ao WABA. Substitua {VERSION} por uma versão atual da API do Graph, por exemplo v21.0 ou posterior.

O que o conector provisiona automaticamente automatic-provisioning

Quando você terminar de criar um fluxo de dados WhatsApp, o conector cria e conecta as entidades a seguir. Você não seleciona um conjunto de dados de destino ou mapeia campos sozinho.

Entidade
Nome ou identificador
Criado ou reutilizado
Notas
Esquema
Eventos brutos do Webhook do WhatsApp (classe XDM ExperienceEvent)
Reutilizado se presente, caso contrário, criado uma vez por sandbox
O primeiro fluxo de dados WhatsApp em uma sandbox o cria. Cada fluxo de dados posterior reutiliza o mesmo esquema.
Grupo de campos
Conteúdo V2 do Webhook do WhatsApp
Reutilizado (padrão)
O conector faz referência ao grupo de campos padrão existente. Nunca cria um.
Conjunto de dados
Eventos Raw do Webhook do WhatsApp
Criado por fluxo de dados
Conjunto de dados bruto de eventos de experiência de aterrissagem para as mensagens de entrada.
Mapeamento de campo
Gerado pelo sistema
Criado por fluxo de dados
Mapeia a carga bruta do webhook para o esquema e é conectada ao fluxo de dados como uma transformação.
Endpoint de transmissão (entrada)
Exibido como o URL de retorno
Criado por fluxo de dados
Impõe a validação de assinatura X-Hub-Signature-256 e o handshake de token de verificação.
Conexão do Target (data lake)
Gerado pelo sistema
Criado por fluxo de dados
Direciona os dados mapeados para o conjunto de dados.

Girar segredos rotate-secrets

Você pode girar o Segredo do aplicativo ou Verificar token a qualquer momento atualizando a conexão. A Platform oferece suporte a um segredo principal e um secundário, para que você possa acumular o Segredo do aplicativo sem tempo de inatividade. Adicione o novo valor como o segredo principal, mantendo o valor anterior como o segredo secundário durante a transição. A atualização da conexão aplica a alteração a todos os fluxos de dados que a utilizam.

Solução de problemas troubleshooting

A tabela a seguir descreve problemas comuns e como resolvê-los.

Sintoma
Causa provável e correção
Tudo no Platform parece íntegro, mas nenhum dado é assimilado.
O aplicativo não está inscrito no WABA. Conclua a assinatura WABA descrita em Inscreva seu aplicativo no WABA. Essa é a causa mais comum e falha silenciosamente. Se o aplicativo estiver inscrito, confirme se o Segredo do Aplicativo na Plataforma corresponde ao Segredo do Aplicativo atual no Meta em Configurações do Aplicativo > Básico.
Falha ao “Verificar e Salvar” no Meta.
O token de verificação no Meta deve corresponder exatamente ao token de verificação inserido na Platform.

Conectar WhatsApp ao Experience Platform connect-to-platform

A documentação abaixo fornece informações sobre como criar um conector de streaming WhatsApp para se conectar ao Experience Platform usando a interface do usuário:

Conectar o WhatsApp ao Experience Platform usando a interface connect-to-platform-using-ui

Recursos adicionais additional-resources

recommendation-more-help
experience-platform-help-sources