Conecte o WhatsApp oficial

O WhatsApp oficial conecta seu número à Spryx pela API da Meta. É a única forma de usar templates e de acompanhar a saúde do número dentro da Spryx. Você conecta pela própria Spryx, numa janela de login da Meta.

Antes de começar

• Uma conta do Facebook com acesso à empresa na Meta. É com ela que você autoriza a Spryx na janela da Meta.
• O número que vai atender pelo WhatsApp. Ele pode ser de dois tipos:
  • Um número que já está no app WhatsApp Business do celular. Ative Continuar usando o WhatsApp Business no celular e o número funciona nos dois lugares ao mesmo tempo.
  • Um número que não está em uso no app. Deixe essa opção desligada. O número passa a funcionar só pela API.

Conectar o número

1. Vá em Configurações → Canais e clique em Conectar canal.
2. Escolha WhatsApp Business (descrição: "API oficial da Meta. Habilita templates e métricas de saúde.") e clique em Continuar.
3. Preencha o Nome do canal, por exemplo "WhatsApp Suporte". Só o seu time vê esse nome, no Ao Vivo e nos filtros.
4. Em Visibilidade, escolha Todos do workspace ou Times específicos. Com Times específicos, só os membros dos times escolhidos veem as conversas do canal.
5. Ative Continuar usando o WhatsApp Business no celular se o número já está no app (veja acima).
6. Se quiser que um agente de IA atenda primeiro, ative Responder com IA e escolha em Quem responde (veja a próxima seção).
7. Clique em Conectar canal. Abre a janela da Meta.
8. Na janela da Meta, entre com o Facebook, escolha a empresa e o número e siga as etapas até o fim.
9. De volta à Spryx, aparece Conectando... e, no fim, a mensagem Canal WhatsApp criado com sucesso!. O canal entra na lista como Conectado.

Se você fechar a janela da Meta antes de terminar, o canal não é criado. É só clicar em Conectar canal de novo.

Se você ativou o uso no celular

• As conversas que você responde pelo app do celular também aparecem na Spryx.
• Logo após conectar, a Spryx importa o histórico do app. O andamento aparece na aba Visão Geral do canal, por exemplo Importando histórico do WhatsApp — 40%.
• Se aparecer Falha ao importar histórico do WhatsApp, aprove de novo o compartilhamento de histórico no app do WhatsApp para tentar outra vez.

Esse modo se chama coexistência. Consulte o guia dedicado antes de conectar um número que já está no aplicativo WhatsApp Business.

Escolher quem responde: agente de IA ou workflow

Com Responder com IA ligado, um agente responde automaticamente antes de passar a conversa para o time. Em Quem responde, a lista mostra duas seções:

• AGENTES: os agentes de IA publicados do workspace.
• WORKFLOW: os workflows publicados.

Se o agente ou workflow que você procura não aparece, confira se ele já foi publicado.

Para mudar depois, abra o canal (Configurar), clique em Editar e use Usar IA e Quem responde. Com Usar IA ligado, a mesma janela mostra Reativar IA quando o contato voltar a falar. Com ela desligada, uma conversa reaberta por mensagem do contato volta com a IA pausada, para atendimento humano.

Editar o perfil do WhatsApp

O perfil é o que seus clientes veem ao abrir o contato da sua empresa no WhatsApp.

1. Em Configurações → Canais, clique em Configurar no canal.
2. Abra a aba Configurações e role até Perfil do WhatsApp.
3. Troque a foto com Adicionar foto ou Trocar foto (JPG ou PNG de até 5 MB; o ideal é quadrada, 640×640).
4. Edite Recado, Categoria, Descrição, Endereço, E-mail, Site e Site adicional. O Recado não pode ficar vazio.
5. Clique em Salvar perfil. As alterações vão direto para a Meta.

O nome de exibição não muda pela Spryx. Ele é alterado no WhatsApp Manager e passa por análise da Meta.

Acompanhar a saúde do número

Na aba Saúde do canal você vê os dados que a Meta informa sobre o número:

• Qualidade: Alta, Média ou Baixa, conforme o estado informado pela Meta para o número.
• Verificação: a situação do nome de exibição, como Aprovado, Em revisão ou Recusado.
• Throughput: quantas mensagens por segundo o número pode enviar.
• Limites e uso recente: os indicadores de volume e capacidade que a Meta disponibiliza para o número.
• Por categoria: a distribuição disponível entre Marketing, Utilidade, Autenticação e Serviço.

Quando houver uma ação disponível, a Spryx abre o painel da Meta para você revisar o número. A saúde ajuda a acompanhar a operação, mas não substitui a página oficial de preços.

Entenda as regras antes de enviar

O WhatsApp oficial tem duas regras que merecem guias próprios:

• a Meta define e atualiza a cobrança da plataforma; consulte os valores na fonte oficial;
• mensagens livres só podem ser enviadas durante a janela de 24 horas; fora dela, use um template aprovado.

Quando o canal desconecta

O canal aparece como Desconectado quando você clica em Desconectar ou quando a conta deixa de estar ligada à Spryx do lado da Meta. Para voltar:

1. Abra o canal e clique em Reconectar.
2. Confira a opção Continuar usando o WhatsApp Business no celular e clique em Reconectar.
3. Na janela da Meta, autorize o mesmo número do canal.

Reconectando o mesmo número, você mantém o canal e todo o histórico de conversas. Se escolher outro número, aparece o erro "Não foi possível reconectar o WhatsApp. Confirme que selecionou o mesmo número."