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

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

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

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

Configurações Iniciais

Como integrar o Zapisp com o seu IXC

1. Para gerar o token, é preciso ir no seu IXC em menu Configurações > Usuários > Usuários > Novo. 2. Após clicar em Novo, este é o formulário que deverá ser preenchido. É de suma importância que seja marcada a opção 'Permite acesso ao webservice', tendo marcado essa opção, pode-se clicar no botão Salvar. 3. Após Salvar, o Token será gerado automaticamente. Devido ao token se basear no ID e senha do usuário, caso for alterada a senha do usuário, automaticamente o token será alterado. 4. No Zapisp, vá em Aplicativos e selecione o ERP IXC 5. Em URL do Webservice cole o link da sua guia do IXC, como na imagem abaixo 5.1 No fim do seu URL do Webservice adicione /webservice/v1 como na imagem abaixo: 6. Para testar, copie o link da URL do Webservice e cole em uma nova guia do Google, se aparecer uma caixa de mensagem como na imagem abaixo tudo correu bem com seu link. 7. Já em Token de Integração cole o Token de acesso que o seu IXC gerou para você, para finalizar clique em Ativar. 8. Precisamos que o nosso IP esteja liberado pelo seu IXC, para isso você precisa acessar a opção Configurações > Usuários > Grupos de usuários > e liberar para o nosso IP 3.94.151.200 como mostrado na foto: Pronto! Agora está tudo certo com sua integração, seus clientes serão importados automaticamente

Campanhas

Como configurar mensagens para clientes aniversariantes no IXC

Configurando a mensagem de aniversário 1. No seu IXC você você deve ir em Configurações > Parâmetros > Parâmetros Gerais. 2. Dentro de Parâmetros gerais, selecione a opção CRM. Após isso, selecione a "Lupa" na região de Mensagens para clientes aniversariantes. 3. Para adicionar uma nova mensagem, você clicará em "Novo". 4. Selecione o Gateway que representa a Zapisp ("Gammu"), digite o nome do remetente (Obs.: Colocar poucas letras) e no campo de mensagem adicione o código da campanha criada na Zapisp. Obs.: Não adicionar nenhuma variável ou texto no IXC nesse campo, colocar apenas a variável criada pelo Zapisp para o envio da campanha. 5. Faça sempre um envio teste para o seu número, verificando se está tudo certo com a sua campanha. Caso precise editar, faça pelo Zapisp. Em seguida, salve a sua mensagem. 6. Com a mensagem salva e selecionada, salve os parâmetros! Pronto, sua campanha de aniversário será enviada sempre que um cliente fizer aniversário. Mecanismo de envio: O IXC enviará para o Zapisp o código da campanha que foi criada no Zapisp. Assim, quando esse código chegar na fila de envio, ele será decodificado e enviado de acordo com a estrutura da campanha que foi criada no Zapisp. Cadastrando a tarefa de Enviar SMS para clientes aniversariantes de forma automática 7. Após configurado esses parâmetros, configure a rotina de enviar mensagem para clientes aniversariantes em Ferramentas > Agenda De Tarefas. Clique em Novo e escolha a tarefa de Enviar SMS clientes aniversariantes. 8. No campo minuto configure coloque um valor entre 0 a 59 minutos. No campo hora coloque um valor entre 01 a 24. No campo dia do mês coloque a opções "todos" caso envie todos os dias ou valor coloque um valor entre 1 a 31. No campo mês coloque a opções "todos" caso envie todos os meses ou valor coloque um valor entre 1 a 12. No campo Dia da semana coloque a opções "todos" caso envie todos os dias ou valor coloque um valor entre 0 a 6, sendo 0 para domingo, 1 segunda e assim por diante. Caso precise enviar de segunda a sexta adicione 1-5. Importante lembrar que a tarefa precisa ser configurada em um horário que não tenha nenhuma outra tarefa configurada. 💡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