Central de Ajuda

Como criar um template de CSAT para o OpaSuite

Abrir em
Ver como Markdown Abrir no ChatGPT Abrir no Claude
Murilo

Murilo

Última atualização em Sep 10, 2026

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