Perguntas frequentes sobre o Cadastro Incorporado

A empresa é a proprietária da própria conta do WhatsApp Business (WABA, pelas iniciais em inglês) e poderá visualizá-la no Gerenciador de Negócios. O acesso a essa WABA será automaticamente compartilhado com o provedor de soluções empresariais (BSP, pelas iniciais em inglês), por meio do site usado para o cadastro, após a conclusão do fluxo de cadastro incorporado. A empresa não precisa tomar nenhuma medida para adicionar o BSP à WABA.

Consulte WABAs são de propriedade das empresas.

Quando uma empresa compartilha uma conta do WhatsApp Business com um provedor de soluções empresariais (BSP, pelas iniciais em inglês), o BSP recebe um email e uma notificação do Gerenciador de Negócios. Consulte Gerenciar contas, compartilhar notificações.

No momento, uma empresa só pode compartilhar o acesso à conta do WhatsApp Business com uma parte: o provedor de soluções empresariais. Exploraremos opções para elas compartilharem o acesso com mais partes no futuro.

Os usuários do sistema de administração não precisam ser explicitamente adicionados a uma WABA, pois eles têm acesso automático a todos os ativos.

A abordagem recomendada é usar usuários do sistema de acesso do funcionário, e esses são os usuários que precisam ser adicionados a cada WABA criada, pois eles não têm acesso por padrão. Essa recomendação é puramente baseada em riscos potenciais de segurança. Como os tokens de acesso do usuário do sistema são válidos por um longo período, um vazamento do token pode ser um convite a uma possível violação de segurança, especialmente se a conta tiver permissões de administrador para toda a conta comercial. Dito isso, se você optar por manter um usuário do sistema de administração, não será preciso adicioná-lo à WABA.

Não. No momento, as empresas não podem restringir o acesso, pois elas possuem a conta do WhatsApp Business e podem visualizá-la no Gerenciador do WhatsApp.

Once the Embedded Signup flow is complete and all the business profile information is captured, the certificate will be available for download.

Beginning May 2, 2022, after signup, a compliance check with the WhatsApp platform policies is auto-triggered and performed in the background. If this check fails, we notify businesses via email and the account is disabled. Businesses have the ability to appeal.

As empresas precisam iniciar a verificação da empresa (BV) quando estiverem prontas para expandir as conversas iniciadas pela empresa, incluir números de telefone adicionais ou solicitar uma conta comercial oficial (OBA).

Quando uma empresa atinge os limites, ela recebe orientações no produto sobre como atualizar iniciando a BV. Não há mudanças nos processos atuais de BV ou OBA. Após a aprovação, as empresas podem enviar conversas iniciadas pela empresa a mil clientes exclusivos e aumentar com base em nossos requisitos de atualização de limites de mensagens.

Beginning May 2, 2022, the display name review is initiated after Business Verification (BV) is completed. The display name can be updated at any time. Any updates to the display name post BV have to go through a review again. For more details, visit Display name documentation.

No momento, nenhuma alteração está sendo feita em outras verificações.

Os provedores de soluções empresariais (BSPs, pelas iniciais em inglês) podem baixar certificados assim que a empresa se cadastra. Neste momento, você também deve iniciar o cliente da WhatsApp Business API para que a empresa possa enviar mensagens enquanto estiver em um estado não verificado.

Os certificados podem ser baixados para números de telefone em teste e para números de telefone que concluíram todas as verificações (verificação da empresa, verificações do WhatsApp, uma análise do nome de exibição). Para baixar um certificado, use o ponto de extremidade phone_numbers ou o Gerenciador do WhatsApp. Apenas BSPs podem baixar certificados – as empresas não têm permissão para fazer isso.

Se uma empresa não for aprovada em nossas verificações, desconectaremos seu número. Notificamos o provedor de soluções de negócios (BSP) e a empresa por email e por notificações do Gerenciador de Negócios. Nesse momento, o WhatsApp desativa o número de telefone e o BSP deve encerrar a instância do cliente da WhatApp Business API para a empresa em questão.

Algumas contas do Gerenciador de Negócios já foram verificadas por outros motivos. Se um Gerenciador de Negócios já foi verificado, ele ainda precisa ser aprovado em nossas outras verificações (nome de exibição, política de comércio etc.) antes de poder enviar um grande número de mensagens. Até que essas verificações sejam concluídas, eles ainda terão acesso à experiência de avaliação não verificada.

Se uma empresa deseja usar uma conta de Gerenciador de Negócios que já foi verificada, mas não é um administrador nessa conta, ela pode tentar o seguinte:

• Solicitar inclusão na conta do Gerenciador de Negócios como administrador.
• Solicitar ao administrador da conta do Gerenciador de Negócios para passar pelo fluxo de cadastro incorporado.
• Criar uma nova conta do Gerenciador de Negócios e passar pela verificação da empresa usando essa conta.

Para obter informações sobre como solicitar e adquirir permissão, consulte Análise do aplicativo.

A análise do aplicativo consiste em duas partes:

1. Verificação do aplicativo — Avalia se o aplicativo funciona, segue o caso de uso descrito e atende aos padrões de qualidade da experiência do usuário
2. Análise de permissões — Avalia se o desenvolvedor solicitou apenas as permissões de que precisa

Os provedores de soluções de negócios (BSPs) precisam da permissão business_management para gerenciar as contas empresariais de seus clientes e compartilhar sua linha de crédito com a empresa do cliente.

Os provedores de soluções empresariais precisam da permissão whatsapp_business_management para gerenciar números de telefone e modelos de mensagem, bem como enviar mensagens e atribuir usuários à conta do WhatsApp Business.

É preciso incluir provas claras de que o aplicativo usa as permissões business_management e whatsapp_business_management. Inclua um vídeo que demonstre a integração do cadastro incorporado e comprove o caso de uso por meio de notas do desenvolvedor detalhadas.

Siga as diretrizes de gravação de tela para carregar vídeos e capturas de tela da integração, do que acontece após a conclusão do processo e de como os usuários podem enviar mensagens no modo sandbox.

O acesso padrão será aprovado automaticamente para todas as permissões e todos os recursos disponíveis aos aplicativos de negócios. Com isso, será possível usar gravações de tela para demonstrar um caso de uso possível para cada permissão solicitada. Consulte a documentação Níveis de acesso para ver mais informações.

As empresas que se cadastram por meio do fluxo incorporado solicitam acesso à linha de crédito do provedor de soluções empresariais (BSP, pelas iniciais em inglês) para pagar pelo acesso à Plataforma do WhatsApp Business. Dessa forma, as empresas pagam o BSP, que recebe uma fatura agregada para o pagamento à Meta.

Para conceder acesso às empresas, os BSPs devem compartilhar a própria linha de crédito.

No momento, as empresas não podem pagar o WhatsApp diretamente.

O acesso a essa linha de crédito pode ser cancelado para determinadas empresas no Gerenciador de Negócios da Meta ou com uma série de chamadas de API.

O provedor de soluções empresariais (BSP), como proprietário da linha de crédito, será o "recebedor da fatura" de todas as empresas que compartilham a linha de crédito do BSP. O BSP tem a responsabilidade de pagar a Meta por todos os gastos das empresas relativos à WhatsApp Business API.

O fluxo de cadastro incorporado funciona apenas em navegadores da web, e não em dispositivos móveis ou navegadores para celular. Verifique se os clientes sabem como se cadastrar na web.

O código de integração do Login do Facebook é escrito em JavaScript básico, é independente de bibliotecas front-end e funciona com qualquer estrutura JavaScript.

Somente parceiros de provedores de soluções empresariais (BSP, pelas iniciais em inglês) podem usar o fluxo de cadastro incorporado nos próprios sites. Não é permitido usar o fluxo em propriedades de terceiros. Forneceremos mais orientações caso isso mude.

Uma empresa precisa se cadastrar com o número de telefone e o nome de exibição que pretende usar com a Plataforma do WhatsApp Business. É altamente desaconselhável fazer o cadastro com um telefone de teste ou pessoal, assim como um nome de exibição provisório, pois será difícil alterar essas informações no futuro.

Uma empresa não pode se cadastrar com um número de telefone já registrado para uso no WhatsApp Messenger ou no aplicativo WhatsApp Business.

No momento, as empresas não podem se cadastrar com números de IVR no fluxo, pois isso impossibilita a verificação do telefone.

O número de telefone fica ativo assim que o provedor de serviços comerciais registra o número. Se o processo for bem-sucedido, o número será ativado dentro de minutos.

Uma empresa poderá alterar o nome de exibição no Gerenciador de Negócios após a conclusão da análise do original. A seguir, será necessário passar novamente pela análise do nome de exibição.

O provedor de soluções empresariais (BSP, pelas iniciais em inglês) receberá um e-mail e uma notificação do Gerenciador de Negócios quando o nome novo for aprovado. A partir desse momento, será necessário baixar o certificado novamente e atualizar o cliente da WhatsApp Business API. Os BSPs também podem configurar webhooks para rastrear as alterações de nome.

No momento, as empresas não têm acesso ao Suporte Direto. Estamos avaliando os planos de longo prazo do Suporte Direto e divulgaremos atualizações conforme elas surgirem.

Um retorno de chamada do Login do Facebook será enviado quando uma empresa concluir o fluxo de cadastro incorporado. A seguir, o provedor de soluções empresariais poderá consultar as contas do WhatsApp compartilhadas recentemente e baixar o certificado.

Para provedores de soluções empresariais

Um retorno de chamada do Login do Facebook será enviado quando uma empresa concluir o fluxo de cadastro incorporado. O provedor de soluções empresariais (BSP, pelas iniciais em inglês) pode consultar as contas do WhatsApp Business compartilhadas recentemente e baixar o certificado. A conta do WhatsApp Business da empresa também é compartilhada com o BSP.

Além disso, os BSPs precisam oferecer suporte às organizações durante o processo de verificação da empresa para garantir que elas entendam as etapas e forneçam a documentação correta.

Para empresas

Assim que o processo de cadastro for concluído e todas as informações do perfil comercial forem registradas, o certificado estará disponível para download. As empresas podem responder a conversas ilimitadas iniciadas por clientes (em janelas de mensagens de 24 horas) e enviar conversas iniciadas pela empresa para 50 clientes únicos em um período contínuo de 24 horas.

As organizações devem iniciar a verificação da empresa quando estiverem prontas para expandir as conversas iniciadas pela empresa, incluir um número de telefone adicional ou solicitar uma conta comercial oficial.

Verifique se uma forma de pagamento válida foi anexada à conta do WhatsApp Business. Caso contrário, ocorrerá falha no envio de modelos de mensagem.

Verifique se o aplicativo do Facebook tem as permissões business_management e whatsapp_business_management. Caso isso não resolva o problema, abra um tíquete do Suporte Direto. Forneça as informações do aplicativo e as etapas necessárias para que a equipe de suporte encontre o problema.

No fluxo de cadastro incorporado, o usuário pode selecionar ou criar apenas uma conta do WhatsApp Business por vez. Porém, nós damos suporte à repetição do fluxo e à criação ou seleção de outra conta do WhatsApp Business.

Lembre-se de que a principal mudança no fluxo de cadastro incorporado é que o cliente será proprietário tanto do Gerenciador de Negócios quanto da conta do WhatsApp Business e compartilhará ambos com o provedor de soluções empresariais.

O fluxo de cadastro incorporado está disponível em 30 idiomas. O fluxo localizado é acionado automaticamente com base no idioma em que o cliente final usa o Facebook. Para ver mais detalhes, consulte Traduções na Visão geral.

Não. O fluxo é padronizado para todos os provedores de soluções empresariais (BSPs, pelas iniciais em inglês) a fim de que as empresas que se cadastrarem tenham a mesma experiência. Os BSPs controlam a experiência antes e depois do fluxo de cadastro incorporado, incluindo as próximas etapas, para onde encaminhar as empresas, entre outros.

Assim que a empresa concluir o registro do fluxo do oAuth de cadastro incorporado, o retorno de chamada JavaScript obterá o accessToken que pode ser usado com o ponto de extremidade Debug-Token para buscar as contas do WhatsApp Business compartilhadas.

O ponto de extremidade client_whatsapp_business_accounts também pode ser usado para recuperar uma lista de todas as contas compartilhadas.

Ao usar o ponto de extremidade Debug-Token, você receberá a mesma lista de contas empresariais do WhatsApp compartilhada pela organização. Para filtrar as duplicatas, faça a correspondência dessas identificações com as que houver no seu lado.

Os target_ids retornados pelo ponto de extremidade Debug-Token são identificações das contas do WhatsApp Business compartilhadas pela organização durante o fluxo de cadastro incorporado.

The client_whatsapp_business_accounts endpoint returns all client-owned WhatsApp Business Accounts that are shared with the Solution Partner.

If two WhatsApp business accounts were created at the same time through the embedded signup flow, the API response captures both WhatsApp Business Accounts.

In order to detect new phone numbers added to a WhatsApp Business Account, we'd recommend using the phone_numbers endpoint. It returns all client-owned WhatsApp Business Accounts that have been assigned to the Solution Partner, regardless of whether it is new or has a phone number set up yet.

Clients can create multiple WhatsApp Business Accounts under the same business ID. Client’s business information can be fetched with the WhatsApp Business Account endpoint.

Example request

curl -i -X GET "https://graph.facebook.com/v21.0/{business-id}/
  owned_whatsapp_business_accounts?
  access_token=system-user-access-token"

Example response

{ 
    "data": [
        {
            "id": 1906385232711451, 
            "name": "My WhatsApp Business Account", 
            "currency": "USD", 
            "timezone_id": "1", 
            "message_template_namespace": "abcdefghijk_12lmnop" 
        },
       {
            "id": 1972385232711141, 
            "name": "My Regional Account", 
            "currency": "INR", 
            "timezone_id": "5", 
            "message_template_namespace": "12abcdefghijk_34lmnop" 
        },

    ],
    "paging": {
	"cursors": {
		"before": "abcdefghij"
		"after": "klmnopqr"
	}
   }
}

O cliente pode passar pelo fluxo de cadastro incorporado novamente, selecionar uma conta empresarial do WhatsApp existente e incluir um novo número de telefone. Para detectar essa alteração, você pode consultar o ponto de extremidade phone_numbers de todas as contas empresariais do WhatsApp do cliente e verificar se um telefone novo foi adicionado.

É possível filtrar contas do WhatsApp Business ou classificá-las com base na data de criação.

É possível filtrar e classificar contas do WhatsApp Business com base no horário de criação.

No momento, o compartilhamento de contas do WhatsApp Business está desativado fora do fluxo de cadastro incorporado.

As empresas que usam números de telefone já registrados no WhatsApp Messenger ou no aplicativo WhatsApp Business não podem usar esses números para o cadastro incorporado. Se o número já estiver sendo usado, será preciso excluí-lo.

As instruções sobre como excluir o número e solicitar outro para o cadastro incorporado do WhatsApp estão em Migrar número de telefone.

Se a conta ainda não tiver sido analisada, o número estará qualificado para uma experiência de avaliação não verificada de 30 dias. Durante este período, o número pode ser registrado e usado para alcançar um número limitado de usuários. Assim que o nome de exibição da conta e do número de telefone forem verificados, o número estará disponível para uso comum.

Se a conta não for analisada em 30 dias, a experiência de avaliação não verificada expirará e o número será desconectado. Quando isso acontece, as empresas precisam verificar a conta para registrar o número novamente.

As empresas podem incluir números de telefone na conta do WhatsApp Business acessando a conta empresarial do Facebook e adicionando os números desejados.

No momento, o cadastro incorporado não é compatível com a recuperação do nó de número de telefone. É possível recuperar o número de telefone e os dados do certificado fazendo uma chamada à borda phone_numbers no nó de uma conta do WhatsApp Business usando o seguinte:

https://graph.facebook.com/v21.0/{{WABA-ID}}/phone_numbers?fields=display_phone_number,name_status,certificate,new_certificate,new_name_status

Para obter mais informações, consulte Gerenciamento de conta do WhatsApp Business, Inscrição.

• As limitações de volume da Standard Graph API e as limitações de volume de casos de uso de empresas se aplicam.
• Usuários múltiplos de um sistema contam como um único usuário.
• O uso do token de acesso do usuário retornado do fluxo do oAuth aumentará a contagem de usuários e, consequentemente, suas limitações de volume.

• Token de acesso do usuário: um token de curta duração retornado do fluxo do oAuth que pode ser usado para buscar a lista de contas do WhatsApp Business compartilhadas com você. Consulte a documentação sobre tokens de acesso para ver mais informações.
• Token de usuário do sistema: os usuários do sistema representam servidores ou softwares que fazem chamadas de API para ativos gerenciados por um Gerenciador de Negócios. Os tokens de usuário do sistema são de longa duração e não têm prazo de validade. Esses tokens ainda estão sujeitos à invalidação por outras razões, mas não expirarão exclusivamente com base no tempo. Se você gerar um novo token de usuário do sistema, os tokens antigos permanecerão válidos e terão as mesmas permissões que o novo, a menos que elas sejam revogadas. Assim que você adicionar o usuário do sistema à conta do WhatsApp Business, será possível fazer chamadas à API para gerenciar a conta no futuro.

O usuário do sistema especificado não tem permissão para atualizar a WABA (conta do WhatsApp Business). Confirme se o referido usuário do sistema tem acesso à WABA. Caso contrário, o usuário deve ser adicionado à WABA.