Conexão do WhatsApp no Ouvia
Atualizado em 29 de outubro de 2026
O Ouvia se conecta ao WhatsApp pelo Z-API. Durante a ativação da sua conta, a equipe Ouvia cria o canal, conecta o seu número com você e configura o recebimento de mensagens. Você não precisa contratar o Z-API, criar conta lá nem informar nenhuma chave.
Importante
- O canal do Z-API está incluído na sua assinatura do Ouvia e é gerenciado pela nossa equipe.
- Nunca envie senhas, tokens ou códigos de acesso por e-mail ou WhatsApp. Para conectar por QR Code, a leitura é feita no seu celular, em uma chamada com a equipe.
- No WhatsApp Oficial, a Meta cobra pelas mensagens de template diretamente no cartão do seu Portfólio Empresarial.
Qual tipo de conexão escolher?
| WhatsApp Web (QR Code) | WhatsApp Oficial | Oficial com Coexistência | |
|---|---|---|---|
| Para quem | Começar rápido, sem burocracia | Número novo ou que pode sair do app | Número que já usa o app WhatsApp Business |
| Portfólio Empresarial na Meta | Não precisa | Precisa | Precisa |
| Continua usando o app no celular | Sim | Não | Sim |
| Mensagens após 24h sem resposta do cliente | Livres | Só com template aprovado | Só com template aprovado |
| Risco de bloqueio do número | Maior (não oficial) | Baixo | Baixo |
Como a equipe conecta
- Na ativação, combinamos com você o tipo de conexão e o número que vai atender.
- QR Code: em uma chamada rápida, você lê o QR Code no celular (WhatsApp › Aparelhos conectados › Conectar um aparelho). Oficial: você autoriza o número na janela da Meta com o seu Portfólio Empresarial.
- Fazemos um teste de envio e recebimento. Depois disso, o estado aparece em Canais e você já pode atender.
Templates (só WhatsApp Oficial)
Cobranças atrasadas, lembretes de agendamento e o Pix são mensagens em que o Ouvia fala primeiro. No WhatsApp Oficial, se o cliente não escreveu nas últimas 24 horas, a Meta só deixa enviar um template aprovado. Sem template, esses envios falham e aparecem como “não enviada” na conversa.
- No Gerenciador do WhatsApp da Meta (ou pedindo à equipe Ouvia), crie um template para cada caso que você usa, na categoria Utilidade e no idioma pt_BR. Use as variáveis
{{1}},{{2}}… onde entram os dados do cliente. - Espere a aprovação da Meta (normalmente minutos; às vezes até 24h).
- No Ouvia, em Canais → WhatsApp, na seção Mensagens fora da janela de 24h, escolha o template de cada caso e diga qual informação preenche cada variável.
Textos sugeridos (copie, ajuste e envie para aprovação):
| Caso | Texto sugerido | Variáveis no Ouvia |
|---|---|---|
| Cobrança atrasada | Olá {{1}}, identificamos uma pendência de {{2}} com vencimento em {{3}}. Responda esta mensagem para regularizar ou negociar. | Nome do cliente, Valor, Vencimento |
| Lembrete 24h antes | Olá {{1}}, lembrete do seu horário: {{2}} em {{3}} às {{4}}. Para remarcar, responda esta mensagem. | Nome do cliente, Serviço, Data, Hora |
| Lembrete 1h antes | {{1}}, seu horário de {{2}} é hoje às {{3}}. Até já! | Nome do cliente, Serviço, Hora |
| Pix gerado | Olá {{1}}, segue o Pix de {{2}} com vencimento em {{3}}. Pix Copia e Cola: {{4}} | Nome do cliente, Valor, Vencimento, Pix Copia e Cola |
Dentro da janela de 24h, o Ouvia envia o texto normal, sem template. No WhatsApp Web (QR Code) não existe janela nem template. Cada template entregue é cobrado pela Meta no cartão do seu Portfólio Empresarial.
Problemas comuns
| O Ouvia mostra | O que significa | Como resolver |
|---|---|---|
| Canal desconectado | O número caiu (celular sem internet, sessão encerrada ou app Business sem uso há 15 dias) | Nossa equipe é avisada automaticamente. Se for QR Code, combine com o suporte uma nova leitura |
| Em configuração | A equipe ainda está ativando a sua conexão | Aguarde o contato da equipe ou fale com o suporte |
| Fora da janela de 24h | No Oficial, o cliente não escreveu nas últimas 24h e não há template escolhido para esse envio | Escolha um template aprovado em Canais → WhatsApp (veja “Templates” acima). Respostas da equipe só saem depois que o cliente escrever |
| Template sumiu | O template escolhido foi apagado ou reprovado na Meta | Crie ou corrija o template na Meta e escolha de novo no Ouvia |
| As mensagens não chegam no Ouvia | O recebimento de mensagens parou | Em Canais, clique em Verificar conexão: o Ouvia recria o recebimento. Se continuar, fale com o suporte |
Quem atende o quê
| Assunto | Quem |
|---|---|
| Conexão do número, canal do Z-API e recebimento de mensagens | Suporte do Ouvia |
| Portfólio Empresarial, verificação e cobrança de templates na Meta | Meta (com ajuda do suporte do Ouvia) |
| IA, conversas, agenda, cobranças, assinatura e campos do Ouvia | Suporte do Ouvia |