Façanha Digital

Façanha Digital — Gerador de Evidência Meta App Review

whatsapp_business_messaging · whatsapp_business_management · business_management

WhatsApp Façanha Digital

Configuração

WABA, números, templates, perfil business e apps do webhook.

Envio real — a Meta devolve um wamid verificável.

Business Manager: dados, WABAs próprias e de cliente, system users.

A evidência não substitui o screencast exigido pela Meta.

Chamadas

ocioso
1
Cole o Access TokenSystem User ou Graph API Explorer, com os scopes do app em revisão
2
Descubra os IDsWABA, número e empresa saem do próprio token
3
Gerar evidênciaas chamadas reais à Graph API aparecem aqui, agrupadas por permissão

Evidência

como o trace-id é capturado
A evidência aparece aqui — no mesmo formato de docs/evidencia-*.txt.

Chamadas ao vivo — os filtros dos contadores continuam valendo aqui

Guia da submissão — Meta App Review

Antes de gravar

Vale para os três vídeos. A Meta reprova por forma, não só por conteúdo.

Nos textos de submissão, APP é marcador — troque pelo nome do aplicativo em revisão, junto com os campos entre colchetes.

O .txt gerado aqui é anexo técnico, não substitui o vídeo. Screencast que mostra curl, Postman ou Graph API Explorer reprova — a Meta quer a interface real do app.

Os 3 erros que mais derrubam vídeo

  1. Não mostrar o login Meta completo na tela. Precisa aparecer o popup do Embedded Signup, o usuário entrando, a tela de consentimento com a lista de permissões e a volta ao app. Conta já conectada = reprova.
  2. Não executar o caso de uso de ponta a ponta. Não basta abrir a tela: faça a ação e mostre o resultado real (mensagem chegando no celular, template aprovado na lista).
  3. App fora do inglês. A revisão é em inglês. Se a UI estiver em português, ative legendas em inglês explicando cada passo.

Preparação

  • Gravar em 1280×720 ou mais, sem cortes no meio do fluxo.
  • Ter em mãos um segundo celular com WhatsApp para mostrar a mensagem chegando.
  • Informar usuário e senha de teste no formulário da submissão, com o canal já disponível para conectar.
  • Deixar a WABA desconectada antes de gravar — o vídeo precisa mostrar a conexão acontecendo.

whatsapp_business_messaging

Enviar e receber mensagens de atendimento pelo número da WABA do próprio cliente.

Texto para colar nas observações da permissão (inglês)

APP is a multi-channel customer service platform (SaaS). Businesses connect
their own WhatsApp Business Account (WABA) to APP and use it as the inbox
where their agents talk to their own customers.

HOW THE USER GRANTS THE PERMISSION (shown in the screencast):
The business owner opens Settings - Channels - New connection - WhatsApp and
clicks "Connect with Facebook". The Meta Embedded Signup popup opens: the user
signs in, selects the Business and the WhatsApp Business Account, selects the
phone number, and the Meta consent screen lists the requested permissions. The
whole front-end flow is visible in the video.

WHAT THE PERMISSION IS USED FOR:
Two-way customer service messaging, the core feature of APP. Incoming customer
messages arrive through the webhook and are shown in the agent inbox. The agent
replies from the APP inbox, which calls POST /{phone-number-id}/messages to
send text and media, and POST /{phone-number-id}/messages with status "read" to
mark the customer message as read. When the 24-hour customer service window is
closed, the agent starts the conversation with an approved message template
through the same endpoint.

WHY IT IMPROVES THE USER EXPERIENCE:
The business handles WhatsApp, Instagram, Messenger and other channels from a
single inbox, with history, assignment to agents and queues, instead of passing
one phone around the team.

SERVER-TO-SERVER NOTE:
The WABA is connected through the front-end Meta login shown in the video, and
every message is triggered by the agent in the APP UI. Automated replies and
scheduled messages run on a backend job on the user's behalf, but the
authorization always comes from the front-end login demonstrated here.

TEST ACCOUNT: [usuario/senha de teste] - WhatsApp number used in the video:
[numero].

Roteiro do screencast

  1. Faça: abrir o APP já logado, em inglês. Diga: "This is APP, a customer service platform. I'm going to connect a WhatsApp Business account."
  2. Faça: Settings → Channels → New connection → WhatsApp. Diga: "I start a new WhatsApp connection."
  3. Faça: clicar em Connect with Facebook; o popup do Embedded Signup abre. Diga: "The Meta login opens."
  4. Faça: entrar, escolher o Business, a WABA e o número. Diga: "I sign in and select my Business, my WhatsApp Business Account and the phone number."
  5. Faça: pausar 2s na tela de consentimento, com a lista de permissões visível. Diga: "This is the Meta consent screen. I grant the requested permissions."
  6. Faça: concluir; mostrar o canal como Connected com o número. Diga: "The WhatsApp Business account is now connected to APP."
  7. Faça: do segundo celular, enviar uma mensagem para o número conectado. Diga: "A customer sends a message to the business."
  8. Faça: mostrar a mensagem chegando na inbox do APP em tempo real. Diga: "The message arrives in the agent inbox through the webhook."
  9. Faça: abrir o atendimento e responder pelo APP. Diga: "The agent replies from APP."
  10. Faça (essencial): mostrar a resposta chegando no celular do cliente. Diga: "The reply is delivered to the customer on WhatsApp."
  11. Faça: enviar uma mensagem de template pelo seletor de templates. Diga: "Outside the 24-hour window, the agent starts the conversation with an approved template."
  12. Faça: mostrar o template chegando no celular. Diga: "The template message is delivered."

whatsapp_business_management

Gerenciar a WABA conectada: números, templates, perfil da empresa e webhook.

Texto para colar nas observações da permissão (inglês)

APP is a multi-channel customer service platform (SaaS). After a business
connects its own WhatsApp Business Account (WABA), APP manages that WABA on
the user's behalf, from the APP dashboard.

HOW THE USER GRANTS THE PERMISSION (shown in the screencast):
Same front-end Meta Embedded Signup flow shown for messaging: Settings -
Channels - New connection - WhatsApp - "Connect with Facebook". The user signs
in, selects the Business, the WhatsApp Business Account and the phone number,
and grants the permissions on the Meta consent screen. The whole flow is visible
in the video.

WHAT THE PERMISSION IS USED FOR:
1) Reading the connected WABA and its phone numbers, so the user can pick which
   number APP will use and see its quality rating and messaging limit
   (GET /{waba-id}, GET /{waba-id}/phone_numbers, GET /{phone-number-id}).
2) Message templates: APP has a template manager where the user lists, creates
   and deletes their own templates, and sees the approval status returned by
   Meta (GET/POST/DELETE /{waba-id}/message_templates). Templates are required
   to start conversations outside the 24-hour window.
3) WhatsApp business profile: the user edits the "about" text, description,
   address, e-mail and website of their own number from APP
   (GET/POST /{phone-number-id}/whatsapp_business_profile).
4) Subscribing the app to the WABA webhook so incoming messages reach the inbox
   (POST /{waba-id}/subscribed_apps).

WHY IT IMPROVES THE USER EXPERIENCE:
The business manages templates, profile and numbers in the same tool where it
talks to customers, instead of switching to the WhatsApp Manager.

SERVER-TO-SERVER NOTE:
All management actions are triggered by the user in the APP UI, using the
authorization obtained in the front-end login demonstrated in the video.

TEST ACCOUNT: [usuario/senha de teste].

Roteiro do screencast

  1. Faça: repetir os passos 1 a 6 do vídeo de messaging (o login Meta completo precisa aparecer também aqui).
  2. Faça: abrir a tela do canal e mostrar o número, quality rating e limite vindos da WABA. Diga: "APP reads the WhatsApp Business Account and its phone numbers."
  3. Faça: abrir Templates e mostrar a lista carregada da WABA. Diga: "This is the template manager, listing the templates of the connected account."
  4. Faça: clicar em New template, escolher categoria Utility, idioma e corpo com uma variável. Diga: "I create a new utility template."
  5. Faça: salvar e mostrar o template na lista com status PENDING ou APPROVED. Diga: "The template was created through the API and Meta returned its approval status."
  6. Faça: excluir um template de teste e mostrar sumindo da lista. Diga: "The user can also delete their own templates."
  7. Faça: abrir Business profile, editar o campo about e salvar. Diga: "The user edits the WhatsApp business profile from APP."
  8. Faça (essencial): abrir a conversa no celular e mostrar o perfil atualizado. Diga: "The updated profile is visible to customers on WhatsApp."

business_management

Descobrir quais WABAs o Business do cliente possui ou compartilha, durante a conexão.

Esta é a que a Meta mais recusa por "não necessária". Só peça se o app realmente lista as WABAs do Business na conexão. Se o número já vem escolhido pelo Embedded Signup, remova a permissão em vez de justificar.

Texto para colar nas observações da permissão (inglês)

APP is a multi-channel customer service platform (SaaS). This permission is
used only during onboarding, to let the user choose which of their own assets
APP will connect to.

HOW THE USER GRANTS THE PERMISSION (shown in the screencast):
In the same Meta Embedded Signup flow shown for the WhatsApp permissions:
Settings - Channels - New connection - WhatsApp - "Connect with Facebook". The
Meta consent screen listing the permissions is visible in the video.

WHAT THE PERMISSION IS USED FOR:
After the login, APP reads the Business the user selected and the WhatsApp
Business Accounts it owns or has shared with it, so the onboarding screen can
show the user a list to pick from, instead of asking them to paste IDs by hand
(GET /{business-id}, GET /{business-id}/owned_whatsapp_business_accounts,
GET /{business-id}/client_whatsapp_business_accounts). APP also reads the
business verification status to warn the user when the account is not verified
yet and messaging limits will apply.

WHY IT IMPROVES THE USER EXPERIENCE:
Without it the user would have to find and copy WABA and phone number IDs from
the Meta dashboard by hand, which is the main source of setup errors. APP
does not create, edit or delete anything in the Business - the access is
read-only.

SERVER-TO-SERVER NOTE:
The reads happen right after the front-end login shown in the video, while the
user is on the onboarding screen.

TEST ACCOUNT: [usuario/senha de teste].

Roteiro do screencast

  1. Faça: repetir os passos 1 a 5 do vídeo de messaging, até a tela de consentimento.
  2. Faça: depois do login, mostrar a tela de onboarding com a lista de WABAs do Business carregada. Diga: "APP lists the WhatsApp Business Accounts of the Business I selected."
  3. Faça: escolher uma da lista. Diga: "I pick the account I want to connect."
  4. Faça: mostrar os números daquela conta carregando e escolher um. Diga: "APP loads the phone numbers of that account."
  5. Faça: se aparecer, mostrar o aviso de business verification. Diga: "APP shows the verification status of the business."
  6. Faça: concluir e mostrar o canal conectado. Diga: "The account is connected, without the user having to copy any ID by hand."

Checklist final

Confira item a item antes de enviar cada permissão.

  • O vídeo mostra o popup do Embedded Signup abrindo e o usuário entrando.
  • A tela de consentimento aparece com a lista de permissões legível, pausada por ~2s.
  • O fluxo volta ao app e o canal aparece conectado.
  • O caso de uso roda de ponta a ponta, com o resultado real na tela.
  • Nenhum curl, Postman ou Graph API Explorer aparece no vídeo.
  • A interface está em inglês ou há legendas em inglês.
  • O usuário de teste do formulário funciona e enxerga a tela usada no vídeo.
  • O texto de observações foi colado na permissão certa (cada uma tem o seu).
  • A evidência .txt gerada aqui foi anexada como prova técnica.
Se a recusa disser "caso de uso não permitido", regravar não resolve: ou a justificativa precisa ser reescrita, ou a permissão deve ser removida. Só recusa de screencast se resolve com vídeo novo.