Nesta página: configure as credenciais da API do WhatsApp, os webhooks e uma configuração de canal para conectar sua conta do WhatsApp Business, para que seu ambiente esteja pronto para enviar mensagens do WhatsApp com o Journey Optimizer.
Antes de enviar a mensagem do WhatsApp, você deve configurar o ambiente do Adobe Journey Optimizer e associar-se à conta do WhatsApp. Para fazer isso:
Estas etapas devem ser executadas por um Administrador do Sistema do Adobe Journey Optimizer.
Criar credenciais da API do WhatsApp whatsapp-credentials
-
No painel à esquerda, vá para Administração
>Canais e selecione o menu Credenciais de API. Clique no botão Criar novas credenciais de API. -
Configure suas credenciais de API, conforme detalhado abaixo:
- Token de API: insira seu token de API. Saiba mais em Documentação do Meta
- ID da Conta Comercial: insira o número exclusivo relacionado ao seu portfólio comercial. Saiba mais em Documentação do Meta.
-
Clique em Continuar.
-
Escolha a Conta Comercial do WhatsApp que deseja conectar às suas credenciais da API do WhatsApp.
-
Selecione o Nome do remetente usado para enviar mensagens do WhatsApp.
-
As configurações de número de telefone são preenchidas automaticamente:
-
Classificação de qualidade: reflete o feedback do cliente sobre as mensagens enviadas nas últimas 24 horas.
- Verde: alta qualidade
- Amarelo: qualidade do Medium
- Vermelho: baixa qualidade
Saiba mais sobre Classificação de qualidade
-
Taxa de transferência: indica a taxa à qual seu número de telefone pode enviar mensagens.
-
-
Clique em Enviar quando terminar de configurar suas credenciais de API.
Depois de criar e configurar sua credencial de API, agora é necessário criar seu Webhook para mensagens do WhatsApp. Saiba mais
Criar webhook WhatsApp-webhook
Depois que suas credenciais da API do WhatsApp forem criadas com êxito, você poderá configurar Webhooks para:
- Capturar respostas de entrada para gerenciar o consentimento de aceitação e recusa
- Receber relatórios de entrega, como confirmações de leitura (quando disponíveis) e status de entrega de mensagens
- Habilitar o rastreamento de eventos para análise e relatórios em conjuntos de dados do Adobe Experience Platform
Os webhooks atuam como a ponte de comunicação entre a Plataforma de negócios WhatsApp da Meta e o Adobe Journey Optimizer, permitindo que você receba notificações em tempo real sobre eventos de mensagem e interações do usuário.
Observe que o Meta permite somente um webhook, URL de retorno de chamada e token de verificação, por conta comercial do WhatsApp, mesmo em várias sandboxes ou credenciais do WhatsApp. Os eventos de feedback (Enviados, Entregues, Leitura, Erro, clique de botão) ainda são capturados corretamente em cada sandbox. Eventos de entrada (respostas, palavras-chave de aceitação/recusa/ajuda) são recebidos apenas na sandbox única em que o webhook está registrado, registre-os na sandbox de produção para receber eventos de entrada.
-
No painel à esquerda, navegue até Administração
>Canais, selecione o menu Webhooks do WhatsApp em Configurações do WhatsApp e clique no botão Criar Webhook.
-
Digite um Nome para seu webhook.
-
Na lista suspensa Selecionar configuração, selecione as Credenciais de API criadas anteriormente.
-
Escolha sua categoria de palavra-chave de entrada, como:
- Palavras-chave de aceitação
- Palavras-chave de recusa
- Palavras-chave da Ajuda
- Padrão - Categoria de fallback para todas as mensagens de entrada que não correspondem a outras palavras-chave. Use esta categoria para ativar o rastreamento de eventos (aberturas, relatórios de delivery) em conjuntos de dados do Adobe Experience Platform.
-
Insira suas Palavras-chave e clique em
-
No campo Responder Mensagem, insira a mensagem enviada quando uma palavra-chave configurada for recebida ou selecione uma opção predefinida no menu suspenso.
-
Clique em
-
Clique em Enviar quando terminar de configurar o Webhook do WhatsApp.
-
No menu Webhooks, clique no
-
Para modificar a configuração existente e acessar a URL do Webhook ou o toker de verificação do Webhook, localize o Webhook desejado e clique na opção Editar para fazer as alterações necessárias.
-
Copie o toker de verificação do Webhook gerado aqui e cole-o na interface do Meta como parte da configuração do Webhook.
Para obter instruções detalhadas sobre como e onde adicionar este token de verificação, consulte a documentação do Meta.
-
Acesse e copie o novo URL do Webhook do Webhook do WhatsApp enviado anteriormente.
Agora que seu Webhook está configurado, você pode criar sua configuração do WhatsApp.
Criar configuração do WhatsApp whatsapp-configuration
-
No painel à esquerda, vá para Administração > Canais e selecione Configurações gerais > Configurações de canal. Clique no botão Criar configuração de canal.
-
Digite um nome e uma descrição (opcional) para a configuração e selecione o canal do WhatsApp.
note NOTE Os nomes devem começar com uma letra (A-Z). Ele só pode conter caracteres alfanuméricos. Também é possível usar os caracteres de sublinhado _, ponto.e hífen-. -
Selecione WhatsApp como seu canal.
-
Selecione Ação(ões) de marketing para associar políticas de consentimento às mensagens que usam essa configuração. Todas as políticas de consentimento associadas à ação de marketing são utilizadas para respeitar as preferências dos clientes. Saiba mais
-
Na seção Configurações do WhatsApp, selecione a configuração do WhatsApp criada anteriormente.
-
Digite o Número de Telefone do Remetente que você deseja usar para suas comunicações. Não inclua um sinal “+” antes do número, pois isso pode impedir que o fluxo de recusa funcione corretamente.
-
Use o Campo de Execução do WhatsApp para selecionar entre os atributos do perfil o número de telefone que você deseja usar com prioridade, se vários números estiverem disponíveis no banco de dados. Saiba mais
note NOTE Por padrão, Journey Optimizer usa o número de telefone especificado nas configurações gerais no nível da sandbox. Atualizar esse campo substitui o valor padrão para as jornadas e campanhas que usam essa configuração. -
Depois que todos os parâmetros tiverem sido configurados, clique em Enviar para confirmar. Você também pode salvar a configuração do canal como rascunho e retomar a configuração posteriormente.
-
Depois que a configuração do canal é criada, ela é exibida na lista com o status Processando.
note NOTE Se as verificações não forem bem-sucedidas, saiba mais sobre os possíveis motivos de falha em esta seção. -
Depois que as verificações forem bem-sucedidas, a configuração do canal obterá o status Ativo. Ele está pronto para ser usado para enviar mensagens.
Depois de configurado, você pode aproveitar todos os recursos de canal prontos para uso, como criação de mensagens, personalização, rastreamento de links e relatórios.
Agora você está pronto para enviar mensagens do WhatsApp com o Journey Optimizer.
Solução de problemas de configuração de canal do WhatsApp troubleshooting
Erros HTTP 500 durante a configuração da credencial da API
Se você encontrar um erro HTTP 500 ao configurar as credenciais da API do WhatsApp, siga estas etapas de solução de problemas:
-
Verificar direitos: confirme se sua organização tem o direito
cjm_whatsappprovisionado. Sem esse direito, o canal do WhatsApp não pode ser configurado. -
Validar campos de conta comercial: verifique se todos os campos obrigatórios estão corretamente preenchidos:
- Token de API: deve ser um token de acesso Meta válido com permissões apropriadas. Saiba mais
- ID da Conta Comercial: deve corresponder exatamente à sua ID da Conta Comercial do Meta. Saiba mais
-
Testar credenciais externamente: verifique suas credenciais diretamente com a API do Meta para confirmar se o problema está relacionado às credenciais ou à manipulação de credenciais do Journey Optimizer.
-
Habilitar log avançado: para identificar erros de configuração de servidor interno ou autenticação, habilite logs avançados no ambiente do Journey Optimizer para fornecer informações detalhadas sobre as falhas de chamada de API.
-
Contate o suporte: se o ambiente e os direitos forem confirmados válidos, mas o erro HTTP 500 persistir, contate o representante da Adobe.
Vídeo tutorial video
O vídeo abaixo mostra como configurar o canal do WhatsApp no Adobe Journey Optimizer.
This section contains structured knowledge intended to support interpretation, retrieval, and question answering related to this topic.
For complete understanding, this information should be combined with the documentation on this page. Neither source is intended to stand alone; the page describes the feature, while this section provides additional context that helps disambiguate terminology, intent, applicability, and constraints.
- TL;DR: This page explains how a System Administrator configures the WhatsApp channel in Journey Optimizer by creating WhatsApp API credentials, a Webhook, and a channel configuration to connect a WhatsApp Business account.
Intents:
- Create WhatsApp API credentials and connect a WhatsApp Business Account
- Create a WhatsApp Webhook to capture inbound responses, receive delivery reports, and enable tracking events
- Create a WhatsApp channel configuration and associate marketing actions and consent policies
- Set the sender phone number and WhatsApp Execution Field for a configuration
- Troubleshoot HTTP 500 errors during API credential setup
Glossary:
- API Credentials: The credential set (API Token and Business Account ID) used to connect Journey Optimizer to a WhatsApp Business Account (product-specific)
- API Token: A Meta access token from a System User in the same Business Manager as your WhatsApp assets, used to authenticate (product-specific)
- Business Account ID: Your Meta Business portfolio ID (Business Manager ID), not the WhatsApp Business Account ID (product-specific)
- Webhook: The communication bridge between Meta’s WhatsApp Business Platform and Journey Optimizer that receives real-time notifications about message events and user interactions (product-specific)
- Inbound keyword category: The classification (Opt-in, Opt-out, Help, Default) that determines which auto-response is sent based on user text (product-specific)
- WhatsApp Execution Field: The field used to select, among profile attributes, the phone number to use in priority when several numbers are available (product-specific)
- Quality Rating: A rating (Green/High, Yellow/Medium, Red/Low) reflecting customer feedback on messages sent in the past 24 hours (product-specific)
- Throughput: The rate at which your phone number can send messages (product-specific)
Guardrails:
- These steps must be performed by a Journey Optimizer System Administrator.
- Meta tokens expire after about 60 days; renew the token before it lapses.
- The API Token’s System User needs whatsapp_business_management, whatsapp_business_messaging, and business_management permissions, plus asset-level access to your WhatsApp Business Account.
- Meta allows only one webhook, callback URL, and Verify Token per WhatsApp Business Account, even across multiple sandboxes or WhatsApp credentials.
- Feedback events (Sent, Delivered, Read, Error, button click) are captured correctly in every sandbox, but inbound events (replies, opt-in/opt-out/help keywords) are only received in the single sandbox where the webhook is registered; register it against your production sandbox to receive inbound events there.
- Without specified opt-in or opt-out keywords, standard consent messages are not enabled.
- A profile must have at least one message sent from Journey Optimizer before incoming messages are captured in the dataset.
- Keywords are not case-sensitive (e.g., stop and STOP are treated the same).
- Configuration names must begin with a letter (A-Z), can only contain alpha-numeric characters, and may also use underscore, dot, and hyphen.
- Do not include a ‘+’ sign before the sender phone number, as this can prevent the opt-out flow from working correctly.
- HTTP 500 troubleshooting: the organization must have the
cjm_whatsappentitlement provisioned; without it, the WhatsApp channel cannot be configured.
Terminology:
- Canonical name: WhatsApp channel configuration — Acronym: n/a — variants: channel configuration, WhatsApp configuration
- Synonyms: “Business Account ID” = “Meta Business portfolio ID” = “Business Manager ID”
- Do not confuse: “Business Account ID” (Meta Business portfolio / Business Manager ID) ≠ “WhatsApp Business Account ID” (not entered in this field)
- Do not confuse: “API Credentials” ≠ “Webhook” ≠ “channel configuration” (three distinct setup steps)
- Do not confuse: “Processing” (status while checks run) ≠ “Active” (status once checks are successful and the configuration is ready to deliver)
FAQ:
- Q: What are the steps to configure the WhatsApp channel? — Create WhatsApp API credentials, create a WhatsApp Webhook, then create a WhatsApp channel configuration.
- Q: Who can configure the WhatsApp channel? — A Journey Optimizer System Administrator.
- Q: How often do Meta tokens expire? — About every 60 days; renew the token before it lapses.
- Q: Why are my inbound events missing in some sandboxes? — Meta allows only one webhook per WhatsApp Business Account, so inbound events are only received in the sandbox where the webhook is registered; register it against your production sandbox.
- Q: What does the channel configuration status mean? — It shows Processing while checks run and becomes Active once checks are successful, meaning it is ready to deliver messages.
- Q: What causes an HTTP 500 error during API credential setup? — Possible causes include a missing
cjm_whatsappentitlement, invalid or mismatched API Token or Business Account ID, or credential handling issues; verify entitlements and fields, test credentials with Meta, enable advanced logging, and contact support if it persists. - Q: Why should I not add a ‘+’ before the sender phone number? — It can prevent the opt-out flow from working correctly.