💡 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).

Meta

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).

Configurações Iniciais

Como configurar os parâmetros de cobrança no MK Solutions

1. Para cadastrar um parâmetro de cobrança vá em Configuração > Financeiro > Réguas de Configuração conforme a imagem abaixo: 2. No Tipo de Régua, escolha a opção "Avisos e mensagens de cobrança" depois defina um nome para a régua, se ela é padrão (a régua padrão será automaticamente inserida para novos contratos e cadastros de pessoas) e o horário de envio. - Após informa estes dados, o usuário deverá clicar no botão 'Gravar Registro' na barra de ferramentas Definindo os Eventos - Os eventos serão definidos apenas após o registro das informações acima serem efetuadas. 3. Para criar um novo evento, clique duas vezes no marco na Régua onde deseja cria-lo depois de clicar uma plaquinha com a nova ação será adicionada na Régua, para definir qual será esta ação, clique sobre a plaquinha e depois no botão 'Detalhes'. A linha laranja define o período "Antes do vencimento" e "Depois do vencimento" - Antes do vencimento: um evento no marco -3 da régua, esse evento estará definido para ser realizado 3 dias antes do vencimento - Depois do vencimento: um evento no marco 3 da régua, esse evento estará definido para ser realizado 3 dias depois do vencimento 4. No menu de detalhes, selecione a ação que deseja, dê um título para a mensagem, escolha os meios de envio e os dias que não quer que a mensagem seja enviada para o cliente e depois salve. - Aviso de cobrança: são disparados somente antes do vencimento - Mensagem de cobrança: são disparados somente após o vencimento A execução da rotina será realizada todos os dias no horário definido, com exceção dos dias marcados para serem ignorados

Pós Atendimento

Como criar um template de CSAT para o OpaSuite

💡 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 o template de CSAT (a pesquisa de pós-atendimento) do canal OpaSuite no modo botão de link, que é o formato validado pela ZAPISP. O template nasce no painel da OpaSuite, passa pela análise da Meta e só depois é sincronizado e definido como padrão dentro da ZAPISP. São 5 etapas e leva de 10 a 20 minutos, fora o tempo de análise da Meta. Antes de começar: pré-requisitos - Aplicativo OpaSuite: app OpaSuite ativo na conta e o canal já conectado. - Pesquisa de pós-atendimento: recurso de pesquisa habilitado na conta. - Acesso ao painel da OpaSuite: o template nasce no painel da OpaSuite, não na ZAPISP. É preciso ter acesso para criar o modelo e enviá-lo à análise da Meta. Atenção: a ZAPISP valida o template no momento em que você o define como padrão de CSAT do canal. Um template fora da régua abaixo é recusado na hora de salvar, então vale a pena já criá-lo certo. Dica: toda a resposta acontece na página que o botão abre: nota, "problema resolvido?" e comentário. Não existe formulário dentro do WhatsApp. A régua do template - Cabeçalho (opcional): somente texto, sem variável. Imagem, vídeo ou documento no cabeçalho são recusados em template de pesquisa. - Corpo (obrigatório): no máximo 1 variável. A 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. A ZAPISP preenche a variável com o código único da pesquisa. Nunca dois botões de link, porque isso quebra o envio. A URL do botão é sempre esta: https://zapisp.com.br/api/after-service/{{variavel}} A base fica gravada no template e a ZAPISP envia apenas o código único da pesquisa no lugar da variável. Abaixo, como a mensagem chega ao cliente: Passo a passo São cinco etapas, na ordem. Os passos 1 e 2 acontecem no painel da OpaSuite; os passos 3 e 4, dentro da ZAPISP. 1. Criar o modelo no painel da OpaSuite: acesse Adicionar novo modelo de mensagem e vá até a etapa Cadastro da mensagem. No cabeçalho, escolha Tipo de cabeçalho: Texto e escreva um título curto, por exemplo "Como foi seu atendimento?". No corpo, escreva o convite à pesquisa com uma variável inserida pelo botão de variáveis do próprio editor. Ela vira o nome do cliente. Em seguida, ative Exibir botões, adicione um botão, marque Tipo do botão: Acessar website, escreva algo como "Responder" no texto e, na URL, digite a base e acrescente a variável pelo controle do editor. 2. Enviar para análise e aguardar a aprovação da Meta: ainda no painel da OpaSuite, clique em 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. Qualquer edição posterior gera nova análise e exige repetir os passos 3 e 4. 3. Sincronizar os templates do canal na ZAPISP: na ZAPISP, vá em Aplicativos > OpaSuite > aba Canais > Templates e clique em Sincronizar. É a sincronização que traz o template aprovado para dentro da ZAPISP e faz a plataforma reconhecer a variável do botão. Sempre re-sincronize depois de criar ou editar um template. 4. Definir o template como padrão de CSAT do canal: na mesma tela, 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, a ZAPISP recusa com uma mensagem dizendo o que ajustar. Veja a seção de erros comuns. 5. Pronto, a ZAPISP preenche as variáveis sozinha: no disparo do CSAT, a variável do corpo recebe o primeiro nome do cliente (ou "cliente", se o cadastro não tiver nome) e a variável do botão recebe o código único da pesquisa daquele atendimento. Nenhuma configuração de variável é necessária. Atenção: a variável precisa ser a do editor. Ela deve ficar literal na URL, no formato de chaves duplas. URL colada com a variável codificada não é reconhecida pela ZAPISP: o template cai no modo antigo e o envio falha por contagem de variáveis. E nunca inclua um segundo botão de link: manter só o botão da pesquisa é o cenário validado. Não confunda com a tela "Editar variáveis do template". Essa tela, a dos coringas, 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. O que muda depois de configurar - O domínio do link vem do template: no modo botão, a URL base é a que está gravada no template (zapisp.com.br). A configuração de domínio próprio 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 por template, mesmo quando o template tem mais. Template com dois links sempre falha no envio. - O modo antigo continua funcionando: template sem botão variável (1 ou 2 variáveis, com o link cru no corpo) segue aceito, e a ZAPISP manda nome e link completo no texto. Converte menos que o botão; migre quando puder. - 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 mesmo vale para zapisp_nps no NPS. Validação final Percorra os quatro testes abaixo para confirmar que o canal está pronto. 1. Finalize um atendimento de teste no canal OpaSuite. 2. Confira, na mensagem recebida, se o primeiro nome do cliente aparece no corpo. 3. Toque no botão e confirme que a página da pesquisa daquele atendimento abre. 4. Se o nome e o botão estiverem certos, o canal está pronto. Erros comuns e como resolver - "Template de CSAT não configurado, defina o template padrão e envie novamente": o canal não tem template selecionado no seletor CSAT e não existe template chamado zapisp_pos_atendimento. Volte ao passo 4 e defina 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)": o template tem botão variável, mas duas ou mais variáveis no corpo, ou mais de uma variável em botões. Ajuste o template na OpaSuite para a régua (1 no botão, até 1 no corpo), reenvie para análise e re-sincronize. - "Template OpaSuite ... esperado: uma ou duas variáveis": template sem botão variável, com zero ou três ou mais variáveis no total (modo antigo, com link no corpo). Prefira o modo botão deste guia, ou deixe o corpo com uma ou duas variáveis (nome e link). - Recusa ao salvar o padrão, por causa do cabeçalho: cabeçalho de imagem, vídeo ou documento não é aceito em template de pesquisa. Troque o cabeçalho por texto ou remova-o. - OpaSuite: "Número de variáveis diferente do esperado": 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 a edição. Deixe apenas um botão de link, com a variável literal, e sincronize de novo. E o NPS? A receita é idêntica, com duas trocas. A primeira: a URL do botão aponta para o endereço do NPS, e não o de pós-atendimento. https://zapisp.com.br/api/nps/{{variavel}} A segunda: no passo 4, o template entra no seletor NPS, e não no de CSAT (atalho por nome: zapisp_nps). A régua de variáveis é a mesma. 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).

Configurações Iniciais

Como criar um Gateway da Zapisp no seu IXC

Olá usuário do IXC, integrar o seu ERP com a plataforma é essencial para que você consiga usufruir ao máximo da nossa plataforma, saiba como fazer isso nesse artigo: 1. No seu IXC vá em Configurações > Integrações > Gateway SMS. Após isso clique em "Novo" no canto superior esquerdo da tela. 2. Faça um envio de teste para confirmar que está tudo configurado no seu IXC! Digite uma mensagem e o número do destinatário, em seguida clique em Enviar teste. 3. Mensagem recebida, então tudo certo! A partir deste momento a API estará configurada e funcional. Certifique-se de selecionar o gateway do Zapisp para que as SMS sejam enviadas com o gateway específico. IMPORTANTE: entre em contato com o nosso canal de atendimento para ter acesso as informações da sua instância Toda mensagem gerada pelo IXC usará a API da Zapisp que receberá a mensagem e encaminhará ao WhatsApp do cliente pelo número definido no envio. 💡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

Meta

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”.