WhatsApp Business API - Perguntas frequentes

Posso utilizar o meu número de telefone existente?

Sim. Durante o fluxo de Embedded Signup, pode selecionar um número de telefone existente que já esteja registado no WhatsApp. O número será migrado para a Cloud API. Se escolher o modo de coexistência, pode continuar a utilizar a WhatsApp Business App no mesmo número em paralelo.

Qual o custo do WhatsApp via seven?

As mensagens WhatsApp através da seven consistem em dois componentes de custo:

• Taxas de conversa da Meta - cobradas pela Meta com base na categoria da conversa (Marketing, Utility, Authentication ou Service) e no país do destinatário.
• Taxas da plataforma seven - cobradas por mensagem ou conversa pela seven.

Para detalhes de preços atuais, consulte a página de preços da seven.

Porque é que as minhas mensagens são rejeitadas com "Problema de pagamento na sua conta WhatsApp Business"?

A Meta cobra as taxas de conversa diretamente ao método de pagamento registado para a sua WhatsApp Business Account (WABA) no seu Meta Business Manager. Se não existir um método de pagamento válido, se este tiver expirado ou se uma cobrança tiver sido recusada, a Meta rejeita todas as mensagens com o código de erro 131042. No painel seven, a mensagem surge então como não entregue com a indicação "Problema de pagamento na sua conta WhatsApp Business".

A seven não tem acesso às definições de pagamento da sua conta Meta. Verifique nas definições de pagamento do seu Meta Business Manager se existe um método de pagamento válido registado e definido como predefinição para a sua WABA.

Caso especial: linha de crédito de um fornecedor anterior. Se anteriormente estava ligado através de outro Business Solution Provider (BSP), a linha de crédito desse fornecedor pode continuar atribuída à sua WABA como método de pagamento predefinido, mesmo depois de o acesso do fornecedor à sua conta ter sido removido. Nesse caso, o seu próprio método de pagamento não pode ser definido como predefinição. Nem a seven nem o utilizador podem remover esta atribuição, porque a linha de crédito pertence ao Business Manager do fornecedor anterior. Peça ao fornecedor anterior que liberte a atribuição da linha de crédito para a sua WABA ou contacte o suporte da Meta através de Ajuda > Suporte no seu Business Manager. Assim que a atribuição for removida, o seu próprio método de pagamento passa a ser utilizado e o envio é retomado sem qualquer outra intervenção.

Neste caso, a Meta aceita primeiro a mensagem e só depois a comunica como não entregue. Por isso, a taxa da seven é cobrada nestas tentativas. Consulte os detalhes na página de preços da seven.

Porque é que o envio falha com um erro de modelo?

Fora da janela de 24 horas, a Meta aceita apenas modelos aprovados. Se a Meta rejeitar a mensagem com a indicação de que o modelo não existe (código de erro 132001), normalmente um dos seguintes pontos não corresponde:

• Nome - O nome do modelo no seu pedido difere do nome apresentado em WhatsApp > Modelos. Verifique maiúsculas, minúsculas e underscores.
• Idioma - O modelo não existe no idioma pedido. O código de idioma tem de corresponder exatamente ao código da versão aprovada (por ex. pt_PT ou en_US).
• Estado - O modelo ainda está pendente ou foi rejeitado. Só é possível enviar modelos com o estado Aprovado.

A Meta rejeita estas mensagens logo na submissão. Aparecem no registo com o estado FAILED e a seven devolve automaticamente a taxa da tentativa. Verifique nome, idioma e estado no painel seven em WhatsApp > Modelos e envie novamente assim que o modelo estiver aprovado. Encontra os detalhes do processo de aprovação no artigo Criar modelos de WhatsApp.

O que acontece se voltar a ligar o WhatsApp?

Se executar novamente o fluxo Embedded Signup, é normalmente criada uma nova WhatsApp Business Account (WABA) e a seven cria para ela um novo acesso com um novo ID de serviço (formato WA-XXXXXXXX). O acesso anterior é removido e o ID de serviço antigo deixa de funcionar.

Por isso, depois de voltar a ligar, verifique o seguinte:

• ID de serviço - Utilize o novo ID de serviço nas suas integrações e chamadas à API. Encontra-o em Definições > IDs de remetente.
• Modelos - Os modelos pertencem à WABA. Os modelos da conta antiga não estão disponíveis na nova e têm de ser submetidos e aprovados novamente.
• Método de pagamento - O método de pagamento é registado por WABA no Meta Business Manager e tem de estar definido para a nova conta.

Posso utilizar vários números de telefone?

Sim. Pode ligar vários números de telefone à seven na mesma WhatsApp Business Account (WABA). Cada número pode ser gerido de forma independente no painel seven. Isto é útil se pretender números separados para diferentes departamentos, marcas ou regiões.

O que acontece quando a janela de sessão de 24 horas expira?

Assim que passarem 24 horas desde a última mensagem do cliente, deixa de poder enviar mensagens de sessão em formato livre. Para continuar a conversa, tem de enviar uma mensagem de modelo aprovada pela Meta. A resposta do cliente abre então uma nova janela de sessão de 24 horas.

Como verifico o estado do meu modelo?

Pode ver o estado de todos os seus modelos de mensagem WhatsApp no painel seven:

1. Inicie sessão em dashboard.seven.io.
2. Navegue até WhatsApp > Modelos.
3. Cada modelo apresenta o seu estado atual: Pendente, Aprovado ou Rejeitado.

Se um modelo tiver sido rejeitado, o motivo da rejeição é apresentado para que possa rever e submeter novamente.

Qual é a diferença entre coexistência e migração total?

Escolha coexistência se a sua equipa precisar de continuar a utilizar a Business App em paralelo com a API. Escolha migração total se pretender throughput completo e não necessitar da Business App.

Para mais detalhes, consulte o artigo Coexistência WhatsApp.

Tenho de verificar o meu número junto da Meta?

Sim. A verificação é um passo próprio, posterior ao Embedded Signup, e é obrigatória para o envio. Inicia-a diretamente no painel seven em Definições > IDs de remetente > selecionar a WABA > Números de telefone > Verificar (por SMS ou chamada). Encontra os detalhes em Verificar o número WhatsApp.

Posso enviar mensagens para qualquer número?

Sim, pode enviar mensagens para todos os utilizadores WhatsApp em todo o mundo. Para o primeiro contacto necessita, contudo, de uma mensagem de modelo aprovada. Só quando o destinatário responde se abre a janela de sessão de 24 horas para mensagens em formato livre.