Primeiro, vamos detalhar o processo para que você possa visualizar, quais são os Usuários já cadastrados em seu sistema, vá em Configuração → Geral → Usuário Ao abrir a tela Usuário já conseguiremos visualizar todos os usuários que estão Ativos e cadastrados em seu sistema. Clique no ícone de + e adicione um novo usuário, com o nome Zapisp, e-mail para o logon da integração, senha, e setor, coloque “Geral” ou “Outros”. Depois disso, clique no botão de ações no usuário criado, e em Editar: Em Permissões, adicione apenas a caixinha do API, e salve. Em API, selecione a opção de permite uso do API e salve, após isso, você terá os dados de Host, client secret e token para integrar no Zapisp: Para integrar com o Zapisp, basta colocar as informações que já conseguimos do usuário e do API:

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 — campos dinâmicos representados por {{1}}, {{2}}, {{3}} — 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 — 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).

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 — 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 — 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 — 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 modelo de E-mail no Zapisp

1. Para começar vá em Aplicativos > E-mail. 2. Na página do E-mail você irá acessar Modelos de mensagens e clicar no botão Novo modelo para criar o seu. 3. Adicione um título e um ítem de Texto, clicando em + Adicionar item, adicione o Email desejado e clique em Salvar. 4. Com o modelo salvo, você poderá buscar pelo título clicando em Busque pelo modelo. ATENÇÃO! Nessa página você vai precisar preencher de acordo as configurações do seu servidor SMTP. Caso não saiba onde encontrar, separamos artigos das principais hospedagens do mercado para lhe ajudar a encontrar as configurações de SMTP 👇 - Umbler - Hostoo - Hostgator - Hostinger - Locaweb - Kinghost 💡Dica de ouro: Precisa de mais assistência? Obtenha ainda mais dicas e suporte fazendo parte do Zapisp News, nossa comunidade no WhatsApp exclusiva para clientes para troca de dicas, insights e vivências de provedores

SMS

Como criar um modelo de SMS no Zapisp

Aqui você vai aprender a criar um modelo de SMS do 0 1. Para criar um modelo de SMS, você deve acessar Aplicativos > SMS. 2. Na página do SMS você irá acessar Modelos de mensagens e clicar no botão Novo modelo para criar o seu. 3. Adicione um título e um ítem de Texto, clicando em + Adicionar item, adicione o texto desejado (Lembrando que o limite máximo é de 140 caracteres) e clique em Salvar. 4. Com o modelo salvo, você poderá buscar pelo título clicando em Busque pelo modelo. ATENÇÃO! - Créditos: Antes de realizar o envio se atente ao número de créditos de SMS que você possui, na Zapisp cada credito de SMS corresponde a 1 envio. Para conferir quantos créditos você possui e para comprar mais é só ir em Canais > SMS. Para comprar clique em Comprar SMS e você será colocado diretamente em contato com o nosso time comercial. - Coringas: Ao utilizar coringas na sua mensagem SMS fique atento pois assim que o coringa é substituido pode resultar em uma mensagem com mais de 160 caracteres. Isto quer dizer que o seu cliente receberá a mensagem cortada exatamente no 160º caracter.

Pós Atendimento

Como criar um template de CSAT para o OpaSuite

O CSAT (pesquisa de pós-atendimento) pelo canal OpaSuite sai como template de WhatsApp com botão de link: o cliente toca no botão e responde numa página da Zapisp. Este guia mostra como criar o template no painel da OpaSuite, sincronizá-lo no Zapisp e defini-lo como padrão do canal — e o que o Zapisp preenche sozinho no disparo. Antes de começar, confira: - Zapisp 9.15.0 ou superior (necessário para o botão de link com variável) - App OpaSuite ativo e canal conectado - Pesquisa de pós-atendimento habilitada A régua do template O Zapisp valida o template quando você o define como padrão de CSAT do canal. Um template fora dessa régua é recusado na hora de salvar — melhor já criá-lo certo. Anatomia aceita (modo recomendado, com botão de link variável): - Cabeçalho — opcional. Somente texto, sem variável. Imagem, vídeo ou documento no cabeçalho são recusados para template de pesquisa. - Corpo — no máximo 1 variável (recomendado). O Zapisp preenche essa variável com o primeiro nome do cliente. Duas ou mais variáveis no corpo: recusado. - Rodapé — opcional. Texto livre. - Botão — obrigatório. 1 botão "Acessar website" com 1 variável no fim da URL: https://zapisp.com.br/api/after-service/{{variavel}}. O Zapisp preenche a variável com o código único da pesquisa. Nunca use dois botões de link — isso quebra o envio. Passo a passo 1. Crie o modelo no painel da OpaSuite No painel da OpaSuite (o template nasce lá, não no Zapisp) — Adicionar novo modelo de mensagem. Na etapa Cadastro da mensagem, preencha seguindo a régua: - Cabeçalho (opcional): tipo de cabeçalho Texto e um título curto, ex.: “Como foi seu atendimento?”. - Corpo: o convite à pesquisa, com uma variável inserida pelo botão { } do editor — ela vira o nome do cliente. Ex.: “Olá, {{variavel}}! Seu atendimento acabou de ser finalizado...” - Botões: ative Exibir botões, adicione um botão e marque Tipo do botão: Acessar website. No Texto, algo como “Responder”; na URL, digite a base e acrescente a variável pelo controle do editor: https://zapisp.com.br/api/after-service/{{variavel}} Armadilha: a variável precisa entrar como variável do editor, ficando literal na URL (｛｛...｝｝). URL colada com a variável já codificada (%7B%7B...%7D%7D) não é reconhecida pelo Zapisp — o template cai no modo antigo e o envio falha por contagem de variáveis. Evite botões extras: além de nunca poder haver um segundo botão de link, manter só o botão da pesquisa é o cenário validado. 2. Envie para análise e aguarde a aprovação da Meta Ainda no painel da OpaSuite — Enviar para análise da Meta. Todo template de WhatsApp passa pela análise da Meta antes de poder ser disparado. Aguarde o status de aprovado no painel da OpaSuite. Qualquer edição posterior no template gera nova análise — e exige repetir os passos 3 e 4. 3. Sincronize os templates do canal no Zapisp Aplicativos › OpaSuite › aba Canais › Templates No canal desejado, clique em Templates e depois em Sincronizar. É isso que traz o template aprovado para dentro do Zapisp — e é na sincronização que o Zapisp reconhece a variável do botão. Sempre re-sincronize depois de criar ou editar um template na OpaSuite. Um template sincronizado por uma versão antiga do Zapisp (antes da 9.15.0) também precisa de uma nova sincronização para o botão variável ser reconhecido. 4. Defina o template como padrão de CSAT do canal Na mesma tela — Templates padrão Abra Templates padrão, escolha o seu template no seletor CSAT e salve. A validação da régua roda neste momento: se o template fugir das regras, o Zapisp recusa com uma mensagem dizendo o que ajustar (veja a tabela de erros abaixo). Atalho por nome: se existir no canal um template chamado exatamente zapisp_pos_atendimento, ele é usado como padrão de CSAT quando nenhum outro foi selecionado (o seletor mostra “Usar padrão Zapisp”). O mesmo vale para zapisp_nps no NPS. 5. Pronto — o Zapisp preenche as variáveis sozinho Nenhuma configuração de variável é necessária para a pesquisa. No disparo do CSAT, o Zapisp monta os valores automaticamente: - Variável do corpo → primeiro nome do cliente (ou “cliente”, se o cadastro não tiver nome). - Variável do botão → o código único (hash) da pesquisa daquele atendimento. A URL base já está no botão do template — vai só o código. Não confunda com a tela “Editar variáveis do template” (coringas): ela serve para usar o template em campanhas. Para o CSAT automático, mapear coringa não é necessário — e o que estiver mapeado lá não é usado pelo disparo da pesquisa. Para conferir, finalize um atendimento de teste e verifique a mensagem: nome no corpo, botão abrindo a página da pesquisa. Erros comuns e o que fazer - “Template de CSAT não configurado, defina o template padrão e envie novamente” — Causa: o canal não tem template selecionado no seletor CSAT e não existe template chamado zapisp_pos_atendimento. O que fazer: passo 4 — definir o template em Templates padrão. - “...com botão de link variável, use uma variável no botão e no máximo uma no corpo (o nome do cliente)” — Causa: template com botão variável, mas com 2+ variáveis no corpo — ou mais de uma variável em botões. O que fazer: ajustar o template na OpaSuite para a régua (1 no botão, até 1 no corpo), reenviar para análise, re-sincronizar. - “Template OpaSuite ... esperado: uma ou duas variáveis” — Causa: template sem botão variável com 0 ou 3+ variáveis no total (modo antigo, link no corpo). O que fazer: preferir o modo botão deste guia; ou deixar o corpo com 1–2 variáveis (nome + link). - “Recusa ao salvar o padrão (cabeçalho)” — Causa: cabeçalho de imagem, vídeo ou documento — não aceito em template de pesquisa. O que fazer: trocar o cabeçalho por texto (ou removê-lo). - OpaSuite: “Número de variáveis diferente do esperado” — Causa: a OpaSuite recusou o envio: template com um segundo botão de link (invisível para a integração), variável codificada na URL, ou canal sem re-sincronizar após edição. O que fazer: deixar apenas 1 botão de link, variável literal ｛｛...｝｝, e sincronizar de novo. Limitações do canal - O domínio do link vem do template — no modo botão, a URL base é a gravada no template (zapisp.com.br); a configuração de domínio da empresa não se aplica. É a mesma limitação do canal Meta oficial. - Só um botão de link por template — a API da OpaSuite expõe apenas um botão de URL, mesmo quando o template tem mais. Template com dois links sempre falha no envio — não há contorno hoje. - O modo antigo continua funcionando — template sem botão variável (1–2 variáveis, link cru no corpo) segue aceito: o Zapisp manda nome + link completo no texto. Migre quando puder. - Toda a resposta acontece na página — diferente do canal Meta com Flows, aqui não há formulário dentro do WhatsApp: nota, “problema resolvido?” e comentário são coletados na página que o botão abre. Reenvio da pesquisa reaproveita o mesmo link. E o NPS? Idêntico, com duas trocas: a URL do botão aponta para https://zapisp.com.br/api/nps/{{variavel}} e, no passo 4, o template entra no seletor NPS (atalho por nome: zapisp_nps). A régua de variáveis é a mesma.