Meta Cloud API

A WhatsApp Business Platform (Cloud API) é a conexão oficial da Meta para empresas. Ela não depende de um celular ligado, suporta vários atendentes no mesmo número, mensagens interativas e os modelos de mensagem aprovados pela Meta, que são a forma permitida de iniciar conversas e enviar notificações em volume.

Para usar a Cloud API você precisa de um canal do tipo WhatsApp API (veja Canais) e de uma conta no Gerenciador de Negócios da Meta (Meta Business). O número pode ser um número novo ou o número que já está no aplicativo WhatsApp Business do celular, no modo de coexistência.

1 - Integração

Crie o canal como WhatsApp API, abra os Detalhes e, no painel Meta Cloud API, clique em Assistente de Configuração.

O assistente abre o cadastro incorporado da Meta em uma janela do Facebook:

1. Entre com a conta que administra o negócio na Meta.
2. Escolha ou crie o portfólio empresarial e a conta do WhatsApp Business (WABA).
3. Escolha o caminho do número: conectar o WhatsApp Business App que já está no celular (coexistência) ou cadastrar um número novo, confirmando o código recebido por SMS ou ligação.
4. Conclua. A plataforma recebe o token e o ID da conta e preenche as credenciais sozinha.

Em seguida a plataforma pede para Selecionar Número entre os números da conta e registra o número e o webhook. Para número novo ela ainda pede o PIN de confirmação em duas etapas, que protege o registro do número; no modo de coexistência essa etapa não existe, porque o número já está registrado no aplicativo.

Se preferir, as credenciais podem ser preenchidas à mão (número, ID do telefone, ID da conta e token permanente) e salvas; o botão do assistente continua disponível para registrar o número e o webhook.

Desativação automática

Se a Meta deixar de aceitar o token ou as permissões do número (conta desconectada, token expirado ou número removido da conta), a plataforma desativa o canal, pausa a fila e registra o motivo no histórico de conexões, para não acumular falhas. Refaça o Assistente de Configuração para reativar e depois retome a fila em Filas.

Vídeo

O vídeo abaixo mostra a integração em uma versão anterior da tela. Os passos na Meta são os mesmos; na plataforma, siga o roteiro acima.

2 - Modelos de mensagem

Os modelos (templates) são textos aprovados pela Meta para iniciar conversas de utilidade, marketing e autenticação. Fora da janela de 24 horas depois da última mensagem do contato, só modelos podem ser enviados. Eles passam por análise antes de liberados e podem ser pausados ou desativados pela Meta com base no engajamento e nas denúncias dos clientes.

Acesse Configurações > WhatsApp > Templates.

• Situação: Aprovado, Em análise, Reprovado, Inexistente (foi apagado na Meta) ou No sync (cadastrado só na plataforma, sem envio à Meta).
• Destino: Onde o modelo é usado: Atendimento/Chat, Notif. Manual ou Notif. Agendadas.
• Ativo: Desativa um modelo sem apagá-lo.

As opções de cada linha são Reenviar (só em modelos inexistentes, cria o modelo de novo na Meta), Copiar (abre o formulário com os dados preenchidos), Editar e Excluir. O botão Sincronizar busca na Meta a situação e a qualidade dos modelos de todos os canais Cloud API ativos.

Edição em 24 horas

A Meta só aceita uma alteração por dia em cada modelo. Ao editar um modelo alterado há menos de 24 horas a plataforma avisa e oferece Criar cópia, para enviar como um modelo novo.

2.1 - Criando um modelo

• Nome do Template: Só letras minúsculas e sublinhado; é o nome que a Meta exibe.
• Descrição: Como o modelo aparece nas listas da plataforma.
• Destino: Notificações Agendadas, Notificações Manuais ou Atendimento. O destino define quais cabeçalhos e botões ficam disponíveis.
• Categoria: Utilidade, Marketing ou Autenticação (só em agendadas). A categoria define o preço cobrado pela Meta e as regras de análise.
• Tipo da Mensagem: Padrão ou, quando habilitado para a organização, Detalhes do Pedido com PIX, boleto ou os dois, que mostra a cobrança dentro da mensagem.
• Canal: O canal Cloud API dono do modelo.
• Meta: Automático envia o modelo para aprovação ao salvar; Manual só guarda na plataforma, para modelos criados direto no Gerenciador do WhatsApp.
• Cabeçalho: Estático/Nenhum, Texto, Variável, Imagem, Vídeo ou Documento, conforme o destino. Mídias pedem uma amostra do arquivo.
• Mensagem: O corpo. Variáveis são números entre chaves duplas, em sequência: {{1}}, {{2}}. A mesma variável não pode se repetir.
• Amostras de variáveis: Exemplos de cada variável para a análise da Meta. Não use dados reais de clientes.
• Conteúdo Rodapé: Texto curto no fim da mensagem.
• Botões: Resposta (resposta rápida), Ligar p/ Telefone, URL Estática ou URL Dinâmica (o fim do link vem de uma variável). No destino Atendimento só o botão de resposta é permitido.

A Prévia do modelo, ao lado do formulário, mostra a mensagem como o cliente verá, com cabeçalho, rodapé e botões.

Ao salvar com Meta em automático, a plataforma envia o modelo e informa que ele foi para análise. A situação muda sozinha quando a Meta responde; se demorar, use Sincronizar.

2.2 - Atendimento

Modelos de destino Atendimento são enviados pelo chat para iniciar uma conversa fora da janela de 24 horas: o atendente escolhe o modelo, preenche as variáveis e envia. Aceitam só texto e botões de resposta.

2.3 - Notificações agendadas

Avisos de vencimento, cobrança, assinatura e as notificações do bot em canais Cloud API precisam de um modelo com destino Notificações Agendadas. Na mensagem agendada você escolhe o modelo e indica qual informação entra em cada variável. Veja Notificações > WhatsApp.

2.4 - Notificações manuais

Campanhas e avisos enviados à mão usam modelos de destino Notificações Manuais, que aceitam imagem e vídeo no cabeçalho e botões de link.

Finalizamos por aqui as diferenças da Cloud API. Qualquer dúvida, entre em contato com nossa equipe.