--- title: "Conecte o WhatsApp oficial" category: "Canais / WhatsApp" updatedAt: "2026-10-23T14:24:45Z" url: "https://spryx.ai/help/canais/whatsapp/como-conectar-o-whatsapp-oficial" --- # Conecte o WhatsApp oficial Conecte um número à Spryx pela API oficial da Meta. 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. **Pré-requisitos** - **Permissão:** Precisa da permissão Canais no nível Gerenciar. Nos papéis padrão, só o Admin tem. ## Antes de começar {#antes-de-comecar} - 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. > **Atenção** > > **Escolha o modo certo antes de conectar.** Se o número está no app WhatsApp Business e a opção **Continuar usando o WhatsApp Business no celular** ficar desligada, a conexão não encontra o número e falha. O contrário também vale. ## Conectar o número {#conectar-o-numero} 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**. ![Janela Conectar canal com a opção WhatsApp Business selecionada.](https://cdn.sanity.io/images/qbc9enz0/production/0b4a56131bdafbd945e183fbd93414c28e7c3029-1120x868.png?w=1600&fit=max&auto=format) _Escolha WhatsApp Business para conectar pela API oficial da Meta._ ![Opções de visibilidade Todos do workspace e Times específicos na configuração do canal.](https://cdn.sanity.io/images/qbc9enz0/production/bc5024a52c16bdf76b8f471c831d916f86d8db87-1048x262.png?w=1600&fit=max&auto=format) _Defina se todos do workspace ou somente times específicos poderão acessar as conversas._ ![Opção Responder com IA na configuração do canal.](https://cdn.sanity.io/images/qbc9enz0/production/c4c72dffa89799c07a93c3747b110f5e39ced6bd-1048x128.png?w=1600&fit=max&auto=format) _A resposta automática é opcional e usa um Agente ou Workflow publicado._ 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 {#se-voce-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. [Use o WhatsApp Business no celular com a Spryx](https://spryx.ai/help/canais/whatsapp/use-o-whatsapp-business-no-celular-com-a-spryx) — Use o mesmo número no aplicativo WhatsApp Business e na Spryx. ## Escolher quem responde: agente de IA ou workflow {#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. [Introdução aos Agentes de IA](https://spryx.ai/help/primeiros-passos/introducao-aos-agentes-de-ia) — Entenda como identidade, ferramentas, conhecimento, instruções, comportamento e canais formam um Agente de IA. ## Editar o perfil do WhatsApp {#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 {#acompanhar-a-saude-do-numero} 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 {#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. [Entenda a cobrança do WhatsApp oficial](https://spryx.ai/help/canais/whatsapp/entenda-a-cobranca-do-whatsapp-oficial) — Entenda a cobrança da Meta e consulte os valores oficiais atualizados. [Entenda a janela de 24 horas e os templates](https://spryx.ai/help/canais/whatsapp/janela-de-24-horas-e-templates) — Saiba quando usar mensagens livres ou templates no WhatsApp oficial. ## Quando o canal desconecta {#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." ## Perguntas frequentes ### Posso continuar usando o WhatsApp Business no celular depois de conectar? Sim, se você ativar **Continuar usando o WhatsApp Business no celular** ao conectar. As mensagens enviadas pelo app também aparecem na Spryx. ### Meu agente de IA não aparece na lista de Quem responde. Por quê? A lista mostra só agentes e workflows publicados. Publique o agente ou o workflow e abra a lista de novo. ### Consigo mudar o nome que aparece para o cliente? Não pela Spryx. O nome de exibição é alterado no WhatsApp Manager e passa por análise da Meta. ### Qual a diferença entre o WhatsApp oficial e o conectado por QR Code? O oficial usa a API da Meta e tem templates, perfil e saúde do número. O de QR Code se conecta como um aparelho do WhatsApp Web. Veja [Conecte o WhatsApp por QR Code](/help/canais/whatsapp/como-conectar-o-whatsapp-por-qr-code).