Central de Ajuda

Meta

3 artigos Gabrielli Lima Murilo Por Gabrielli Lima and Murilo

Tudo sobre a integração com a Meta e o uso dos canais conectados no Zapisp

Opt-out no canal Meta

Como o Zapisp pede permissão para enviar, respeita quem pediu para parar, e protege a saúde do seu número oficial. 01 · CONTEXTO Por que existe O WhatsApp oficial pune números que insistem com quem não quer receber: o índice de qualidade cai e o número pode ser suspenso. A Z-API já respeitava quem pedia para sair. O canal Meta, não: disparava campanha, NPS, CSAT e cobrança sem checar nada. Esta funcionalidade traz esse respeito para o Meta. O cliente passa a dizer se quer continuar recebendo, por número, e o Zapisp obedece antes de cada envio. Menos denúncias, número mais saudável, os dois canais no mesmo padrão. 02 · VISÃO GERAL Como funciona São quatro momentos. A resposta do cliente é sempre por botão ou tela, e ele nunca precisa digitar. Os três status possíveis do cliente: A escolha vale por número: sair de um número não afeta os outros. Vale sempre a última resposta. 03 · PEDIR PERMISSÃO A oferta de opt-out É o convite que pergunta ao cliente se ele quer continuar recebendo. Há três formas de enviar, e a empresa escolhe. Todas abrem a mesma telinha de resposta, e o Zapisp registra a escolha sozinho. 1 · Em um template existente (campanha) O botão de opt-out entra em um template que a empresa já usa, então o convite pega carona no disparo que já ia acontecer, e o custo continua o mesmo da campanha. [1.] No Gerenciador do WhatsApp (Meta), edite o seu template de campanha e adicione o botão de Flow apontando para o Flow de opt-out do Zapisp. A edição passa por nova aprovação da Meta. [2.] Dispare a campanha normalmente pelo Zapisp usando esse template. [3.] O botão aparece na mensagem, e a resposta do cliente é registrada automaticamente. 2 · Ao fim da pesquisa (NPS / pós-atendimento) [1.] Ligue “Enviar oferta de opt-out ao fim da pesquisa” nas configurações de NPS e/ou de pós-atendimento (telas na seção 05). [2.] Pronto. Quando o cliente responde a pesquisa, o convite sai sozinho, depois da mensagem de agradecimento. Sai como mensagem de sessão, aproveitando a conversa que o cliente acabou de abrir ao responder a pesquisa, por isso não há cobrança. 3 · Convite avulso (pela integração) [1.] Se quiser, escolha qual template de convite usar no campo “Opt-out” do modal Templates padrão (seção 04). Sem escolha, vale o padrão Zapisp. [2.] Envie pela integração (API do gateway) uma mensagem com a coringa @optout@ no texto. [3.] O Zapisp dispara o template de convite para o cliente. Mensagem cobrada, e só sai se o template estiver aprovado na Meta. Convite avulso na prática: chamada da integração com a coringa @optout@ na mensagem O que o cliente recebe Nas três formas, o convite abre a mesma telinha de resposta: O aviso no convite deixa claro que a escolha vale para aquele número. O convite sai em espanhol para empresas do Paraguai e em português para o resto. 04 · CONFIGURAÇÃO Templates padrão Aqui a empresa escolhe qual modelo de mensagem o Zapisp usa para cada tipo de envio automático, inclusive o convite de opt-out. Sem uma escolha, o Zapisp usa o modelo padrão dele. Quando ele é usado: o template padrão de opt-out serve apenas ao convite avulso (forma 3). A campanha usa o próprio template da empresa, e a oferta ao fim da pesquisa não consome template nenhum. Modal Templates padrão: o campo Opt-out define o template do convite avulso 05 · AUTOMAÇÃO Oferta ao fim das pesquisas Nas configurações de NPS e de pós-atendimento há a opção “Enviar oferta de opt-out ao fim da pesquisa”. Com ela ligada, logo depois que o cliente responde a pesquisa o Zapisp já manda o convite, sem custo, aproveitando a conversa aberta. Pesquisa NPS · Configuração: enviar oferta de opt-out ao fim da pesquisa Pós-atendimento (CSAT): a mesma opção na configuração da pesquisa 06 · EXCEÇÃO Ignorar opt-out em um template Algumas mensagens são essenciais (cobrança, aviso de corte) e precisam sair mesmo para quem pediu para parar. Isso é definido por template: - No editor do template há o botão “Ignorar opt-out do destinatário”. - Os templates com ele ligado ganham o selo Ignora opt-out na listagem. - Vale para qualquer template aprovado, mesmo os sem variáveis. Editor do template: botão Ignorar opt-out do destinatário Listagem de templates: selo Ignora opt-out 07 · ACOMPANHAMENTO Status no cadastro Dá para ver a escolha de cada cliente em dois lugares: a aba “Status do Opt-out” no cadastro do cliente, e a coluna “Opt-out Meta” nas listas de leads e de clientes. Base de clientes: coluna Opt-out Meta Cadastro do cliente: aba Status do Opt-out, histórico por número e Forçar desbloqueio 08 · A LÓGICA Como o envio decide Antes de cada envio por Meta, o Zapisp segue esta ordem: Tudo isso vale por empresa: enquanto a funcionalidade não é ativada para uma empresa, o canal Meta se comporta exatamente como antes. 09 · DÚVIDAS Perguntas frequentes O opt-out bloqueia até a cobrança? Sim. Quem recusa deixa de receber tudo, inclusive a cobrança. O “ignorar opt-out” por template existe justamente para a mensagem essencial pontual. Enquanto a funcionalidade não está ativa, muda alguma coisa? Nada. O canal Meta dispara como sempre disparou, e nenhuma opção nova aparece. Ela é ativada empresa por empresa. Se o cliente nunca respondeu o convite, ele é bloqueado? Não. Sem resposta, o envio é permitido. Só bloqueia quem respondeu “não quero receber” ou “não sou cliente”. Um cliente que saiu consegue voltar? Não por conta própria: a telinha já respondida não aceita uma nova resposta. Para mudar a escolha, ele precisaria receber um novo convite, e envios para quem saiu ficam bloqueados. Na prática, quem libera é o provedor, pelo botão “Forçar desbloqueio” na aba Status do Opt-out do cadastro; a partir daí o cliente volta a receber normalmente. A escolha vale para todos os números da empresa? Não. Vale por número: sair de um não afeta os outros. Quem saiu na Z-API também está bloqueado no Meta? Não. Os dois canais são independentes: quem saiu na Z-API pode voltar a receber pelo Meta (e vice-versa). Enviar o convite para quem já saiu funciona? Não. O convite passa pelo mesmo bloqueio dos demais envios: quem pediu para sair não recebe nem um novo convite. Para reabrir essa conversa, o provedor libera antes pelo “Forçar desbloqueio”.

Como criar um template de mensagem no WhatsApp (Meta)

💡 Este passo a passo é bastante detalhado. Para uma experiência mais visual e intuitiva, com imagens de cada etapa, você também pode ACESSAR MATERIAL EM PDF 💡 Este guia mostra o passo a passo para criar e enviar para aprovação um template de mensagem no Gerenciador do WhatsApp da Meta. Qualquer pessoa da empresa com permissão de administrador na conta do WhatsApp Business pode executar esse processo, que leva de 10 a 15 minutos, mais até 24 horas de análise da Meta. O que é um template e por que a Meta exige aprovação Um template é um texto pré-aprovado pela Meta que permite à empresa iniciar uma conversa com o cliente pelo WhatsApp Business API. Ele pode conter variáveis, que são campos dinâmicos representados por {{1}}, {{2}}, {{3}} e substituídos automaticamente no envio pelo nome do cliente, valor da fatura, data de vencimento, código e assim por diante. Para proteger os usuários contra spam e golpes, toda mensagem ativa (iniciada pela empresa) precisa usar um template previamente analisado e aprovado pela Meta. Mensagens fora do padrão aprovado não são entregues ao cliente. Quando o template é necessário: a janela de 24 horas Quando o cliente escreve para a empresa, abre-se uma janela de 24 horas em que é possível responder livremente, sem template. Fora dessa janela, ou para iniciar a conversa, o envio só é possível por meio de um template aprovado. - Mensagem reativa (resposta): o cliente escreveu primeiro e a janela de 24 horas está aberta. Não precisa de template. - Mensagem ativa (iniciada pela empresa): a empresa inicia a conversa ou responde depois das 24 horas. Só sai com um template aprovado. Cobranças, lembretes, avisos de vencimento e pesquisas de satisfação costumam depender de templates cadastrados, pois normalmente são enviados fora da janela de 24 horas. Pré-requisitos - Ter acesso ao Gerenciador de Negócios da Meta (business.facebook.com) com permissão de administrador na conta do WhatsApp Business (WABA). - Definir previamente a finalidade da mensagem: confirmação de pedido, cobrança, lembrete, boas-vindas, pesquisa de satisfação. - Definir a categoria mais adequada: Marketing, Utilidade ou Autenticação. - Ter em mãos o texto da mensagem e identificar quais partes serão variáveis, representadas por {{1}}, {{2}} e {{3}}. Qual categoria escolher - Utilidade: comunicações sobre uma conta, contrato ou pedido já existente do cliente. Exemplos: fatura disponível, confirmação de agendamento, aviso de manutenção, pesquisa de satisfação pós-atendimento. - Marketing: promoções, ofertas, novidades e qualquer mensagem com apelo comercial. Exemplos: oferta de upgrade de plano, divulgação de novo combo, campanha de indicação, reativação de ex-clientes. - Autenticação: envio de códigos de verificação e senhas de uso único (OTP). Exemplos: código de confirmação de acesso à central do assinante, validação de troca de senha. Na dúvida entre Utilidade e Marketing, pergunte-se: a mensagem se refere a algo que o cliente já contratou? Então tende a ser Utilidade. Se o objetivo é vender, promover ou reconquistar, é Marketing. A própria Meta pode reclassificar automaticamente o template após a análise. Passo a passo da criação 1. Acessar o Gerenciador do WhatsApp: entre em business.facebook.com, faça login e acesse Configurações > Contas > Contas do WhatsApp. Selecione a conta desejada e clique em Gerenciador do WhatsApp. Se o botão não aparecer, verifique se o usuário tem permissão de administrador. 2. Abrir o menu Modelos de mensagens: na página inicial do Gerenciador, localize no menu lateral esquerdo o grupo Modelos de mensagens. 3. Acessar Gerenciar modelos e criar um novo: clique em Modelos de mensagens > Gerenciar modelos para ver a lista de templates existentes com status e categoria. No canto superior direito, clique no botão azul Criar modelo. 4. Escolher a categoria e o tipo do modelo: na etapa Configurar modelo, escolha a categoria (Marketing, Utilidade ou Autenticação) e o tipo. Na maioria dos casos, use Padrão. Clique em Avançar. 5. Definir nome do modelo e idioma: na etapa Editar modelo, preencha "Dê um nome ao seu modelo" com um nome curto e descritivo, em minúsculas e sem acentos, usando underline no lugar de espaços. 6. Conferir o idioma e o bloco Conteúdo: confirme que o idioma foi alterado para Portuguese (BR). Se o idioma do modelo não corresponder ao idioma do texto, a Meta pode reprovar o template na análise automática. 7. Escrever o corpo da mensagem: no campo Corpo, escreva o texto incluindo a variável {{1}} nos pontos em que o nome do cliente (ou outro dado) deve aparecer. Para inserir mais variáveis, use o botão "+ Adicionar variável". Elas serão numeradas em sequência: {{2}}, {{3}} e assim por diante. 8. Preencher a amostra da variável: assim que a variável {{1}} é inserida no corpo, aparece o campo "Exemplo de conteúdo do corpo". Preencha com um dado fictício e nunca use dados reais de clientes nesse campo. 9. Revisar e enviar para análise: confira a prévia do modelo no painel à direita. Se estiver tudo certo, clique em Enviar para análise. 10. Aguardar a análise: o modelo fica com o status Em análise até a Meta concluir a avaliação, normalmente em até 24 horas. Quando aprovado, o template já pode ser usado nos disparos. Se voltar como Reprovado, não há punição à conta: corrija o texto conforme os motivos indicados e reenvie o mesmo modelo, ou crie um novo com outro nome. Erros que causam reprovação - Variável na borda do texto: a Meta bloqueia templates que iniciam ou terminam com variável, ou que tenham variáveis adjacentes. Sempre envolva a variável com texto fixo, como em "Olá, {{1}}! Tudo bem?". - Amostra em branco ou genérica: sem a amostra, o revisor não entende o contexto e reprova por precaução. Preencha com um exemplo fictício realista. - Erros de ortografia ou texto confuso: conteúdo mal formatado é tratado como indício de spam. Revise o texto antes de enviar. - Linguagem de pressão ou cobrança agressiva: viola as políticas de comércio e comunicação da Meta. Adote tom cordial e informativo. - Conteúdo comercial em template de Utilidade: a Meta reclassifica para Marketing ou reprova o modelo. Separe informação da conta em Utilidade e oferta em um template Marketing próprio. - Idioma do modelo diferente do texto: inconsistência detectada na análise automática. Texto em português exige idioma Portuguese (BR). Perguntas frequentes - Posso editar um template já aprovado? Sim, mas ao editar o modelo volta para análise e fica indisponível até nova aprovação. Para uso contínuo, crie uma nova versão com outro nome antes de desativar a antiga. - Quantos templates posso criar? O limite padrão é de 250 modelos por conta (WABA), podendo variar. - Posso usar emojis e formatação no corpo? Sim. Emojis, negrito, itálico e quebras de linha são permitidos com moderação. Excesso pode levar à reprovação por aparência de spam. - O template serve para qualquer número da minha conta? Sim. O template pertence à conta do WhatsApp Business (WABA) e pode ser usado por qualquer número vinculado a ela. - Preciso pagar para criar templates? A criação e a análise são gratuitas. A cobrança da Meta ocorre por conversa iniciada com o envio do template, conforme a categoria. Precisa de ajuda? Se você travar em algum passo, fale com o nosso time de suporte pelo pop-up de ajuda no site ou pelo WhatsApp: +55 84 3190-3931 (wa.me/558431903931).

Como vincular um número à API Oficial do WhatsApp (Meta)

💡 Este passo a passo é bastante detalhado. Para uma experiência mais visual e intuitiva, com imagens de cada etapa, você também pode ACESSAR MATERIAL EM PDF💡 Este guia mostra o passo a passo para conectar um número de telefone à API Oficial do WhatsApp (Meta Cloud API) usando o aplicativo Meta dentro da ZAPISP. O processo é executado pelo responsável da empresa, com a conta do Facebook que administra o Portfólio Empresarial no Meta Business, e leva de 10 a 20 minutos, desde que os pré-requisitos estejam atendidos. Antes de começar: pré-requisitos - Acesso à ZAPISP: usuário com perfil administrador e o aplicativo Meta já adquirido e liberado na conta. Se o app aparecer sem o selo "Adquirido", fale com o time comercial ou com o suporte ZAPISP. - Conta do Facebook: conta pessoal do Facebook que seja administradora do Portfólio Empresarial da empresa. Confira em business.facebook.com > Configurações do negócio > Usuários > Pessoas. - Portfólio Empresarial: criado no Meta Business Suite, com nome e dados da empresa preenchidos. Recomendado: Verificação de Negócio concluída, pois libera limites maiores de envio. - Número de telefone: número válido que possa receber SMS ou ligação para o código de verificação. Pode ser móvel ou fixo. No caso do fixo, a verificação é por ligação. O número não pode estar vinculado a outra conta da API oficial. - Situação do número no WhatsApp: se o número já usa o WhatsApp comum (pessoal), a conta precisa ser apagada antes. Se usa o WhatsApp Business (app), é possível manter o app com a opção de coexistência. - Nome de exibição: nome que aparecerá para o cliente final. Deve ter relação clara com a marca e seguir as políticas da Meta. Evite termos genéricos como "Atendimento" ou "Suporte" isolados. - Meio de pagamento: cartão de crédito cadastrado no Meta Business para o faturamento das mensagens da API, que são cobradas pela Meta. - Somente para coexistência: app WhatsApp Business instalado no celular, na versão 2.24.17 ou superior, número já em uso real há algumas semanas e celular com câmera para leitura do QR Code. Atenção: ao concluir a vinculação sem coexistência, o número deixa de funcionar no aplicativo do celular. Certifique-se de que o número escolhido é realmente o desejado para o atendimento oficial. Dica: use o Google Chrome ou o Microsoft Edge em uma janela normal (não anônima) e desative o bloqueador de pop-ups, porque o fluxo da Meta abre em uma janela pop-up. Feche também outras contas do Facebook conectadas no navegador. Passo a passo 1. Acessar o menu de Aplicativos na ZAPISP: no menu lateral esquerdo, localize o bloco Ferramentas e clique em Aplicativos. 2. Localizar o aplicativo Meta: na vitrine de aplicativos, procure o card Meta, identificado pelo ícone verde do WhatsApp. Clique no card para abri-lo. Se o selo "Adquirido" não aparecer, o aplicativo ainda não está habilitado para a conta. 3. Abrir Configurações e clicar em Novo Número: dentro do aplicativo Meta, acesse a aba Configurações, onde é exibido o total de números já vinculados. Clique no botão Novo Número para iniciar a vinculação. 4. Escolher a opção "Entrar com Facebook": na tela "Configure sua conta da META", selecione Entrar com Facebook, que é o caminho recomendado e usa o fluxo oficial da Meta e configura tudo automaticamente. A opção "Configuração manual" é apenas para cenários específicos, sob orientação do suporte ZAPISP. 5. Autorizar a conexão com a ZAPISP: ao clicar em Entrar com Facebook, abre-se uma janela da Meta. Faça login (ou confirme que já está logado) com a conta que administra o portfólio da empresa e clique em Continuar. A conta logada precisa ter acesso de administrador ao Portfólio Empresarial; se a janela abrir com outra conta, troque antes de continuar. 6. Selecionar o Portfólio Empresarial e a Conta do WhatsApp Business: no campo Portfólio empresarial, selecione o portfólio da empresa e, em seguida, abra o campo Conta do WhatsApp Business. Se a empresa ainda não tiver um portfólio, é possível criá-lo pelo próprio fluxo, informando nome do negócio, site e e-mail corporativo. 7. Escolher entre criar uma conta nova ou conectar o app existente: ao abrir o campo Conta do WhatsApp Business, aparecem duas opções. "Criar uma conta do WhatsApp Business" cria uma conta nova, integrada diretamente à Meta, e o número passa a operar somente pela API, sem o aplicativo no celular. "Conectar um app do WhatsApp Business" ativa o modo coexistência, em que o número continua funcionando no aplicativo do celular e, ao mesmo tempo, na API. Trocar de modalidade depois exige refazer parte do processo, então escolha com calma. 8. Cadastrar o número e validar: informe o nome de exibição, categoria e descrição do negócio, o número de telefone (com código do país +55 e DDD, sem o nono dígito duplicado ou espaços) e o método de verificação (SMS ou chamada de voz). Em seguida, informe o código de 6 dígitos recebido. Na modalidade coexistência, a Meta exibe um QR Code: no celular, abra o WhatsApp Business > menu > Dispositivos conectados > Conectar dispositivo e leia o código. O código de verificação é pessoal e intransferível. Nunca o compartilhe, nem com atendentes da ZAPISP. 9. Concluir o fluxo da Meta: revise o resumo apresentado e clique em Concluir ou Finalizar. Aguarde a mensagem de conclusão antes de fechar a janela. Encerrá-la no meio do fluxo deixa o vínculo incompleto e exige reiniciar o processo a partir do passo 4. 10. Voltar à ZAPISP e sincronizar: de volta ao aplicativo Meta na ZAPISP, acesse novamente a aba Configurações e clique em Sincronizar Telefones. O contador de Total de Números deve ser atualizado e o novo número passará a aparecer na listagem, pronto para uso. O que muda depois da integração - Janela de 24 horas: depois que o cliente envia uma mensagem, a empresa tem 24 horas para responder livremente. Fora dessa janela, só é possível iniciar conversa com template aprovado pela Meta. - Cobrança das mensagens: a Meta passa a cobrar pelo uso da API, no cartão cadastrado no Meta Business. A cobrança é da Meta, não da ZAPISP, e aparece na fatura do portfólio empresarial. - App no celular: na modalidade conta nova, o número deixa de funcionar no aplicativo do celular. Na coexistência, o app continua funcionando em paralelo à API. - Nome de exibição: passa a ser gerenciado pelo Meta Business. Qualquer alteração é submetida à análise da Meta antes de entrar no ar. Validação final Percorra os quatro testes abaixo para confirmar que a vinculação foi concluída com sucesso. 1. Abra a aba Configurações do aplicativo Meta e confirme que o novo número aparece na listagem. 2. Envie uma mensagem de teste a partir da ZAPISP para um número conhecido. 3. Responda a partir desse número e confirme que a resposta chega na plataforma. 4. Se a mensagem sair e a resposta chegar, a vinculação está concluída com sucesso. Erros comuns e como resolver - O portfólio não aparece na lista: a conta do Facebook logada não é administradora do Portfólio Empresarial. Saia da conta na janela da Meta e entre com a conta correta, ou peça acesso de administrador no Meta Business. - A janela da Meta não abre: bloqueador de pop-ups ativo ou navegação anônima. Libere os pop-ups do domínio da ZAPISP, use uma janela normal do Chrome ou Edge e tente novamente. - O número é recusado no cadastro: número já vinculado a outra conta de API oficial ou ainda ativo no WhatsApp comum. Apague a conta do WhatsApp no celular ou desvincule o número da API anterior antes de repetir o passo 8. - O código de 6 dígitos não chega: operadora bloqueando o SMS ou número digitado com o nono dígito duplicado. Confira o formato (+55 + DDD + número), aguarde alguns minutos e solicite a verificação por chamada de voz. - O número não aparece após concluir: a lista da ZAPISP ainda não foi atualizada. Clique em Sincronizar Telefones na aba Configurações. Se persistir, acione o suporte ZAPISP. - O nome de exibição foi reprovado: nome genérico ou sem relação com a marca, contrariando as políticas da Meta. Ajuste o nome de exibição no Meta Business para algo alinhado à marca e solicite nova análise. Precisa de ajuda? Se você travar em algum passo, fale com o nosso time de suporte pelo pop-up de ajuda no site ou pelo WhatsApp: +55 84 3190-3931 (wa.me/558431903931).