Conexões (WhatsApp & Meta Lead Ads)

WhatsApp API Oficial (Meta)

WhatsApp API Oficial (Meta) A API Oficial do WhatsApp (Meta) é a conexão profissional que usa o número oficial da sua empresa direto do servidor da Meta — sem depender de um celular ligado 24h. É a conexão usada por quem quer número fixo da imobiliária, envio em escala e templates aprovados. Para que serve - Recebe e envia mensagens pelo número oficial da empresa. - Funciona sem celular conectado: o WhatsApp roda no servidor da Meta. - Permite iniciar conversas com mensagens aprovadas (templates) fora do horário de atendimento. - Entregabilidade maior para envios em volume (Black Friday, lembretes, follow-ups). Quando usar - Sua imobiliária quer um número oficial de WhatsApp Business com nome verificado. - Você precisa de templates para disparos proativos. - A conexão por QR (celular dedicado) não atende mais o volume. ℹ️ ❓ O que é cada termo? - App na Meta: o "aplicativo" que você cria no painel de desenvolvedores da Meta para conectar o WhatsApp. - WABA: a conta do WhatsApp Business (WhatsApp Business Account) da sua empresa na Meta. - Token: uma chave secreta que autoriza o CRM a falar com a sua conta na Meta em seu nome. - Webhook: um "portal" onde a Meta entrega as mensagens que chegam para você. Configurar o webhook é o passo que faz o CRM receber as mensagens. Antes de começar - Você administra o Meta Business e a conta do WhatsApp Business. - Você tem (ou vai criar) um app na Meta com o produto WhatsApp. - Seu número já aparece como número do WhatsApp Business (ou está pronto para ser cadastrado). - Você é administrador no Imobiturbo.OS. ⚠️ ⚠️ Antes de mexer no seu número Se o número ainda é usado no WhatsApp comum ou no app WhatsApp Business, não apague nada por conta própria. A migração para a API Oficial envolve decidir o uso do número. Em caso de dúvida, fale com a equipe Imobiturbo antes. Passo a passo Parte 1 — Criar (ou escolher) o seu app na Meta Este é o app da sua empresa — não é o app do Imobiturbo. 1. Acesse developers.facebook.com/apps com o perfil que administra o seu Meta Business. 2. Se já existir um app com WhatsApp na lista, abra-o e pule para o passo 4. 3. Se não existir, clique em Criar app e siga: - Escolha o tipo de app voltado para Business quando a Meta perguntar; - Selecione o caso de uso Conectar com clientes através do WhatsApp (ou equivalente em português); - Dê um nome identificável (ex.: CRM da minha imobiliária) e informe um e-mail que você acompanha; - Selecione o seu Business portfolio e confirme. Fluxo de criação de app no painel da Meta Imagem ilustrativa do fluxo de criação de app da Meta. 4. No painel do app, em Adicionar produto, escolha WhatsApp e clique em Configurar. 5. Se o WhatsApp já estiver no menu, abra WhatsApp → Getting Started (ou Configuração da API) direto. Parte 2 — Gerar o token de acesso O token temporário da tela de teste da Meta vence rápido. Para uma conexão que continue funcionando, gere um token de usuário do sistema. 1. Abra business.facebook.com/settings e entre em Usuários → Usuários do sistema (ou System Users). 2. Clique em Adicionar / Criar usuário do sistema: - Dê um nome fácil de identificar, ex.: CRM — minha imobiliária; - Escolha a função administrativa; - Em Ativos atribuídos, associe o seu app e a sua conta do WhatsApp Business. 3. Dentro do usuário criado, clique em Gerar novo token, selecione o seu app e marque: - whatsapp_business_management — gerenciar a conta do WhatsApp Business; - whatsapp_business_messaging — enviar e receber mensagens. 4. Copie o token que a Meta mostrar. Ele é secreto. Geração de token em Usuários do sistema na Meta Imagem ilustrativa do painel de Usuários do sistema da Meta. 🚨 🔒 Nunca compartilhe segredos Não envie o token, o App Secret ou senha por WhatsApp, e-mail ou em prints. Eles são colados somente na tela do CRM, que os guarda criptografados. Parte 3 — Separar os 4 dados da sua conta Antes de abrir o CRM, deixe estes valores prontos (copie exatamente como aparecem, sem espaços): | Dado | Onde encontrar na Meta | O que é | |---|---|---| | ID do número de telefone | WhatsApp → Configuração da API | o Phone Number ID (não é o número com DDD) | | ID da conta do WhatsApp Business | WhatsApp → Configuração da API | o WABA ID | | Token de acesso | token do usuário do sistema (Parte 2) | a chave que autoriza o CRM | | App Secret | Configurações do app → Básico (só se o app for seu) | a chave que valida as mensagens recebidas | Parte 4 — Abrir a tela da API Oficial no CRM 1. Entre no Imobiturbo.OS com um perfil administrador. 2. No menu lateral, abra Conexões. 3. Clique na aba API Oficial (Meta) e permaneça na subaba Conexão. Aba API Oficial (Meta) na Central de Conexões Na imagem, os valores sensíveis estão ocultos. A conexão aparece com os selos "credencial guardada", "App Secret próprio/da plataforma" e o botão Validar e conectar. Parte 5 — Preencher e conectar 1. Em ID do número de telefone, cole o Phone Number ID. 2. Em ID da conta do WhatsApp Business, cole o WABA ID. 3. Em Token de acesso, cole o token do usuário do sistema. 4. Em App Secret, cole a chave do seu app. Deixe vazio apenas se o número foi conectado pelo aplicativo do Imobiturbo — não por um app criado por você. 5. Clique em Validar e conectar. O CRM confere a credencial com a Meta antes de salvar. ℹ️ 💡 Por que o App Secret importa? A Meta assina cada mensagem com a chave secreta do app que envia. Sem o App Secret (quando o app é seu), o CRM recusa tudo o que chega: o envio funciona, mas nenhuma resposta do cliente aparece. Se deixar o campo vazio e não receber mensagens, volte aqui. Como saber que deu certo: o cartão passa a mostrar o nome e o número conectados, com os selos credencial guardada e App Secret próprio (ou da plataforma). Parte 6 — Configurar o webhook na Meta Sem este passo, o canal envia mas não recebe — as respostas do cliente não chegam ao CRM. 1. Na tela do CRM, no card "Cole isto no painel da Meta", use os botões Copiar ao lado de: - URL de callback — o endereço do webhook da sua organização; - Token de verificação — a prova de que o endpoint é seu. 2. Copie também o campo messages (e assine message_template_status_update para acompanhar templates). 3. Volte ao seu app no Meta for Developers, em WhatsApp → Configuração → Webhook. 4. Cole a URL de callback e o Token de verificação, e clique em Verificar e salvar. 5. Depois de salvar, assine o campo messages (e o de templates, se quiser). Como saber que deu certo: a Meta aceita a verificação sem erro e o cartão do CRM continua conectado. Parte 7 — Fazer o primeiro teste 1. De um outro telefone (diferente do número conectado), envie uma mensagem curta para o número oficial. 2. Abra a Inbox do CRM: a conversa deve aparecer. 3. Responda pelo CRM (dentro da janela de atendimento, a resposta é livre). 4. Confirme que a resposta chegou no WhatsApp do cliente. Para iniciar conversas fora da janela de atendimento, use um template aprovado pela Meta: em Conexões → API Oficial (Meta) → Templates da Meta, escolha o template e o envio. Problemas comuns | O que aconteceu | O que fazer | |---|---| | Token inválido | Gere um novo token no usuário do sistema, confira as permissões e cole o valor completo. | | ID do número não encontrado | Use o Phone Number ID (não o número com DDD) e confira se o número pertence à WABA informada. | | Sem permissão na WABA | Associe a conta do WhatsApp Business ao usuário do sistema e conceda whatsapp_business_management e whatsapp_business_messaging. | | Webhook rejeitado | Copie novamente a URL e o token da conexão atual; confira HTTPS, espaços extras e o botão de verificação da Meta. | | Envia, mas não recebe | Duas causas, nesta ordem: (1) o campo messages não está assinado no webhook; (2) falta o App Secret quando o app é seu. | | Conexão parou depois de um tempo | Provavelmente você usou um token temporário. Gere um token de usuário do sistema e troque a credencial no CRM. | Checklist final - [ ] O cartão do CRM mostra o número como conectado. - [ ] A Meta verificou e salvou o webhook. - [ ] O campo messages está assinado. - [ ] O selo do App Secret bate com a sua situação (próprio / da plataforma). - [ ] Uma mensagem de outro telefone apareceu no CRM. - [ ] Você respondeu pelo CRM e recebeu a resposta no WhatsApp. Referências oficiais da Meta - Coleção oficial WhatsApp Cloud API no Postman - Documentação oficial de recebimento e webhook Próximos passos - Visão geral das Conexões - Conectar WhatsApp por QR Code - Receber leads dos anúncios com Meta Lead Ads

Conectar WhatsApp por QR Code

import Tabs from '@theme/Tabs'; import TabItem from '@theme/TabItem'; Conectar WhatsApp por QR Code A sincronização do WhatsApp com o Imobiturbo.OS funciona através de uma conexão segura de multi-dispositivos (semelhante ao WhatsApp Web), permitindo que você continue usando o WhatsApp normalmente no seu smartphone enquanto o sistema opera em paralelo. ℹ️ 📌 REQUISITO BÁSICO Para realizar a conexão inicial, você precisa de um computador ou tablet com o Imobiturbo.OS aberto e o smartphone com o WhatsApp que será conectado em mãos. Fluxo de Navegação Acesse o menu: Menu Lateral ➔ Central de Conexões ➔ + Conectar Novo WhatsApp Passo a Passo de Conexão 1. No computador, abra a Central de Conexões no Imobiturbo.OS. 2. Clique no botão + Conectar Novo WhatsApp (ou Reconectar na instância desejada). 3. A janela com o QR Code será carregada na tela: Modal de Leitura de QR Code Central de Conexões antes de abrir o QR Code 4. No iPhone, abra o aplicativo WhatsApp. 5. Toque em Configurações (no canto inferior direito). 6. Toque em Aparelhos conectados ➔ Conectar um aparelho. 7. Desbloqueie com Face ID ou Touch ID. 8. Aponte a câmera para o QR Code na tela do computador e aguarde a leitura. 1. No computador, abra a Central de Conexões no Imobiturbo.OS. 2. Clique no botão + Conectar Novo WhatsApp (ou Reconectar na instância desejada). 3. A janela com o QR Code será carregada na tela: Modal de Leitura de QR Code 4. No Android, abra o aplicativo WhatsApp. 5. Toque no ícone de 3 pontinhos (no canto superior direito). 6. Selecione Aparelhos conectados ➔ Conectar um aparelho. 7. Confirme a impressão digital ou código PIN do celular. 8. Aponte a câmera para o QR Code na tela do computador e aguarde a sincronização. 💡 💡 DICA DE ESTABILIDADE Após a primeira leitura, a sincronização do histórico recente de mensagens leva entre 10 e 30 segundos. Não feche a página até que a tag verde 🟢 CONECTADO apareça. O que acontece depois da conexão - Status Ativo: O canal exibirá a etiqueta CONECTADO com indicador verde. - Sincronização Contínua: Mensagens recebidas no celular chegam instantaneamente na Inbox. - IA Operacional: Se houver um Agente de IA vinculado a este canal, ele começará a responder novos leads automaticamente. Guia de Resolução de Problemas (Troubleshooting) | Sintoma | Causa Provável | Ação Recomendada | |---|---|---| | QR Code Expirou | Timeout de segurança do WhatsApp (20s) | Clique em Atualizar QR Code no modal e leia imediatamente. | | Erro "Limite de Aparelhos" | O WhatsApp permite até 4 sessões ativas | No celular, vá em Aparelhos Conectados, clique em uma sessão antiga e selecione Desconectar. | | Instância Desconectada | Celular ficou muito tempo desligado ou sem sinal | Acesse a Central de Conexões e clique em Reconectar para gerar novo QR Code. | | Câmera não foca no QR Code | Brilho do monitor muito alto ou tela com reflexo | Aumente a distância do celular da tela ou reduza ligeiramente o brilho do monitor. | ⚠️ ⚠️ ATENÇÃO COM APPS NÃO OFICIAIS O uso de versões modificadas do WhatsApp (ex: WhatsApp GB, WhatsApp Plus) pode causar desconexões repentinas e bloqueios temporários pela Meta. Utilize sempre a versão oficial do WhatsApp ou WhatsApp Business. Próximos Passos - Conheça a Visão Geral da Inbox para gerenciar conversas em tempo real. - Saiba como Pedir Conexão ao Corretor sem precisar pedir a senha dele.

Criar templates de mensagem na Meta (API Oficial)

Criar templates de mensagem na Meta (API Oficial) Os templates de mensagem são mensagens pré-aprovadas pela Meta que o seu número oficial pode enviar por iniciativa própria — fora da janela de atendimento de 24 horas. É o que permite avisos, lembretes, cobranças de documentos e disparos em escala. ℹ️ ❓ Por que os templates existem? No WhatsApp oficial, você só pode conversar livremente com um cliente dentro de 24 horas após ele te procurar. Depois disso, para iniciar uma conversa, a mensagem precisa ser um template aprovado: é a garantia da Meta de que você não vai mandar spam. A criação do template acontece na Meta; o uso dele acontece no Imobiturbo.OS. Antes de começar - Seu número já está conectado na API Oficial. - Você administra a WABA no WhatsApp Manager (business.facebook.com/wa-manager). - Você sabe qual mensagem quer padronizar (ex.: lembrete de visita, solicitação de documentos, aviso de tabela). Passo a passo Parte 1 — Criar o template na Meta 1. Acesse o WhatsApp Manager → sua conta do WhatsApp Business. 2. Abra Ferramentas da conta → Templates de mensagens (ou Message templates). 3. Clique em Criar template. 4. Preencha: - Categoria: escolha com cuidado (afeta aprovação e tarifa): - Marketing: divulgação, ofertas, novidades; - Utilitário (Utility): informação que o cliente pediu ou espera (lembrete de visita, baixa de fatura, código); - Autenticação: códigos de acesso/login. - Nome: com letras minúsculas e _ (ex.: lembrete_de_visita); - Idioma (ex.: português do Brasil). 5. Monte o conteúdo: - Cabeçalho (opcional): texto, imagem, vídeo, documento ou localização; - Corpo: o texto principal. Para personalizar, use variáveis entre chaves — {{1}}, {{2}}... (ex.: "Olá {{1}}, sua visita na {{2}} está agendada para amanhã às {{3}}."); - Rodapé (opcional): texto pequeno (ex.: "Imobiturbo Imóveis"); - Botões (opcional): resposta rápida, link, telefone ou código. 6. Em Valores de exemplo, escreva exemplos reais para cada variável (ex.: Maria, Av. Atlântica 1000, 10h). 7. Clique em Enviar (ou Submit). O template entra em revisão. Parte 2 — Acompanhar a aprovação - O template fica PENDENTE por um tempo (de minutos a algumas horas). - Aprovado → status APROVADO (APPROVED) e pode ser usado. - Recusado → a Meta informa o motivo (ex.: categoria errada, promessa não comprovada, variável sem exemplo). Edite e reenvie corrigindo o motivo. ℹ️ 💡 Regras que facilitam a aprovação - Categoria correta (lembrete/serviço = Utilitário, não Marketing); - Exemplos preenchidos em todas as variáveis; - Sem pedidos financeiros não comprovados (ex.: "pague agora" exige comprovante); - Texto em português correto, sem linguagem de spam (!!!!, CAPS LOCK). Parte 3 — Usar o template no Imobiturbo.OS 1. No Imobiturbo.OS, abra Conexões → API Oficial (Meta) → Templates da Meta. 2. Clique em Atualizar (sincronizar): os templates da sua WABA aparecem com o status, o número de parâmetros e a prévia do texto. Templates da Meta no Imobiturbo.OS Aba API Oficial na Central de Conexões 3. Só templates APROVADOS podem ser enviados — os demais ficam como informação. 4. Formas de usar: - Automação: na regra de automação, a ação Enviar template pela API Oficial dispara o template aprovado; - Disparo em escala: em Conexões → API Oficial → Campanhas, envie um template aprovado para uma lista CSV com intervalo controlado (15 s a 1 h). Como saber que deu certo - O template aparece APROVADO na subaba Templates da Meta no OS. - Uma automação/campanha usando o template entregou a mensagem (visível na conversa na Inbox e na aba Atividade). Problemas comuns | O que aconteceu | O que fazer | |---|---| | Template pendente há horas | Normal na primeira aprovação. Se demorar demais, confira se está tudo preenchido e aguarde. | | Template recusado | Leia o motivo da Meta, corrija (categoria, exemplos, texto) e reenvie. | | Não aparece no OS | Clique em Atualizar na subaba Templates da Meta; confirme que é a mesma WABA conectada no OS. | | Erro ao enviar | Só APROVADO envia; confira também que todas as variáveis foram preenchidas. | | Tarifa diferente entre categorias | Utilitário e Marketing têm tarifas diferentes — escolha a categoria certa desde o início. | Próximos passos - WhatsApp API Oficial (Meta) - Automação pela frase do anúncio - Unificar o número para a API Oficial

Meta Lead Ads (Formulários de anúncios)

Meta Lead Ads (Formulários de anúncios) A integração Meta Lead Ads conecta os Instant Forms da sua Página do Facebook/Instagram ao funil do Imobiturbo.OS. Quando alguém preenche o formulário de um anúncio, o contato entra sozinho no CRM — sem planilha e sem copiar telefone. Para que serve - Cada preenchimento de formulário vira uma oportunidade na etapa certa do seu funil. - As respostas do formulário ficam preservadas no contato. - Você pode combinar a entrada do lead com uma automação (mensagem imediata, etiqueta, distribuição para corretor). Quando usar - Você roda anúncios com geração de leads (Instant Forms) no Facebook/Instagram. - Quer que os leads dos anúncios caiam direto no CRM, sem digitação manual. ℹ️ ❓ O que é cada termo? - Instant Form: o formulário que aparece dentro do anúncio do Facebook/Instagram quando a pessoa clica em "Saiba mais" ou o botão de lead. - Página do Facebook: a página da sua empresa (a que administra os anúncios). - Access token: uma chave que autoriza o CRM a ler os formulários da sua Página. Para este caminho, ele é colado na tela do Imobiturbo. Antes de começar - Você administra a Página do Facebook que roda os anúncios. - A Página já tem pelo menos um Instant Form criado no Gerenciador de Anúncios da Meta. - Você é gerente ou administrador no Imobiturbo.OS. Passo a passo Parte 1 — Abrir a tela Formulários Meta 1. Entre no Imobiturbo.OS. 2. No menu lateral, abra Conexões. 3. Localize o card Formulários Meta (Facebook/Instagram) e clique nele. Tela Formulários Meta (Facebook/Instagram) A tela oferece duas formas de conectar sua Página. Escolha uma: Parte 2 — Conectar a Página Caminho A — Conectar com o Facebook (recomendado) 1. Na seção "Ou conecte com o Facebook", clique em Conectar Facebook. Destaque do botão Conectar Facebook 2. O CRM abre a janela oficial do Facebook. Não feche a janela nem troque de perfil no meio do caminho. 3. Se a Meta perguntar, selecione o Business Manager/perfil correto e depois a Página que receberá os leads. 4. Finalize em Permitir / Continuar (ou botão equivalente). Caminho B — Colar um token de acesso 1. Na seção "Conectar com access token", cole o token da Meta (do Graph API Explorer, de um usuário do sistema no Business Manager ou um token de Página — começa com EAAB…). Destaque da área de access token 2. Clique em Validar token. ℹ️ 🔐 Sobre o token O CRM guarda o token cifrado e ele nunca volta a aparecer na tela. Não compartilhe o token em prints, e-mails ou chamados. Como saber que deu certo: depois de autorizar, a Página aparece conectada na tela. Se a lista ainda estiver carregando, clique em Atualizar. 💡 Como ler os destaques Os círculos numerados mostram exatamente o controle usado naquele passo. Se você escolher o caminho do Facebook, siga o print verde; se preferir token, siga o print azul. Parte 3 — Ativar o Instant Form no funil Conectar a Página não ativa os formulários automaticamente. Você escolhe quais Instant Forms devem criar oportunidades no CRM. 1. Na Página conectada, abra a lista de formulários ("Ver formulários"). 2. Encontre o formulário usado nas suas campanhas. Se nenhum aparecer, confira se ele foi criado na Página correta e clique em Atualizar. 3. Clique em Ativar no formulário desejado e preencha: - um nome fácil de reconhecer; - o funil de destino; - a etapa inicial, normalmente Novo lead; - o mapeamento das perguntas, se o CRM solicitar. 4. Salve e confira o selo Ativo no CRM. Como saber que deu certo: o formulário aparece na seção "Formulários ativos no CRM" com o status Ativo. A partir daí, novos leads desse formulário entram no funil. Parte 4 — Fazer o primeiro teste 1. Teste do CRM: no card do formulário ativo, clique em Enviar lead de teste. Um contato sintético deve aparecer no funil escolhido, com o telefone reconhecido e as respostas do formulário visíveis. 2. Teste real: use a ferramenta Lead Ads Testing Tool da Meta ou preencha o próprio Instant Form com um número de teste (nunca use dados de lead real para testar). Aguarde alguns instantes e atualize o CRM: o contato deve entrar em Novo lead ou na etapa escolhida, com a origem identificada como o formulário Meta. ℹ️ 💡 O teste do CRM não prova a Meta O botão Enviar lead de teste valida funil, etapa e automações. Ele não prova a entrega de um anúncio real. O teste com o formulário de verdade é o que confirma a integração completa. Parte 5 — Automação (opcional) Depois que o lead chega, você pode criar uma automação para responder imediatamente, aplicar uma etiqueta, distribuir para um corretor ou disparar um webhook quando o lead entrar. Veja Follow-ups e Automações. Problemas comuns | O que aconteceu | O que fazer | |---|---| | A Página não aparece no CRM | Confirme o acesso à Página no Meta Business Suite e se escolheu o Business Manager certo durante a autorização. | | Não aparecem formulários | Confirme se o Instant Form foi criado na Página correta, clique em Atualizar e verifique as permissões pendentes na Meta. | | A Página fica "Conectando" | Atualize uma vez. Se persistir, envie um print da tela para a equipe — nunca envie token. | | O teste cria lead, mas o lead real não chega | O teste sintético só valida o CRM. Revise a autorização da Página, o formulário ativo e a entrega do anúncio na Meta. | | Erro: Página já conectada | Uma Página não pode ficar vinculada a duas organizações do CRM ao mesmo tempo. Avise a equipe Imobiturbo. | | Usei o Facebook errado | Saia do perfil, entre com o perfil que administra a Página e repita a conexão. | Dados que ajudam o suporte: nome da Página, nome do formulário, perfil do Facebook usado na conexão, etapa em que o erro apareceu e print da mensagem — sem tokens, códigos ou senhas. Resumo 1. Página conectada ao Imobiturbo. 2. Instant Form ativo no CRM. 3. Lead de teste confirmou funil, etapa e campos. 4. Um lead real entrou no funil com a origem do formulário. Próximos passos - Visão geral das Conexões - Conectar WhatsApp por QR Code - WhatsApp API Oficial (Meta)

Unificar o número para a API Oficial (migração)

Unificar o número para a API Oficial (migração) Essa é uma das dúvidas mais comuns: "quero usar meu número de WhatsApp que já existe, na API Oficial do Imobiturbo — como faço?" Resposta curta: dá para migrar. Quando o número é colocado na API Oficial (Cloud API da Meta), ele deixa de funcionar no WhatsApp do celular e passa a funcionar 100% pelo Imobiturbo.OS. Este guia mostra o caminho inteiro, sem quebrar nada por engano. Tela da API Oficial da Meta na Central de Conexões Preparação do app Meta para a API Oficial ⚠️ ⚠️ Importante A migração não é reversível no dia a dia: depois de registrar o número na API Oficial, o WhatsApp do celular não atende mais aquele número (nem WhatsApp comum, nem WhatsApp Business App). O atendimento passa a ser pelo Imobiturbo.OS. Planeje o aviso à equipe antes. Antes de começar - Você administra o Meta Business e a conta do WhatsApp Business (WABA). - Você já tem um app na Meta com WhatsApp e a WABA (veja WhatsApp API Oficial, Parte 1). - O número que será migrado está com você (pode receber SMS/ligação com o código). - Decida o nome de exibição que o número vai mostrar (ex.: o nome da imobiliária). O passo a passo Parte 1 — Entender o que está migrando | Situação do número hoje | O que acontece na migração | |---|---| | Usado no WhatsApp Messenger (app comum) | Deixa de funcionar no app; passa a ser atendido pelo OS. | | Usado no WhatsApp Business App (app da Meta) | Deixa de funcionar no app; passa a ser atendido pelo OS. | | Já é número da sua WABA (verificado) | Você pula para a Parte 3 — só falta ligar no OS. | ℹ️ ❓ WABA A WABA (WhatsApp Business Account) é a "conta de negócio" do WhatsApp dentro do Meta Business. Cada número de WhatsApp pertence a uma WABA. É a WABA que o Imobiturbo.OS usa para puxar o seu número. Parte 2 — Trazer o número para a WABA (migração na Meta) 1. Acesse o WhatsApp Manager: business.facebook.com/wa-manager e abra a sua conta do WhatsApp Business. 2. Em Números de telefone → Adicionar número. 3. Confirme o nome de exibição e a categoria do negócio. 4. Escolha a verificação do número: - SMS ou ligação: a Meta envia um código de 6 dígitos para o número; - Verificação do negócio (gratuita): se sua empresa já está verificada na Meta, o número pode ser verificado pelo negócio em vez do SMS. 5. Confirme o código. O número agora pertence à WABA. 🚨 ⚠️ Código não chega? Saia do app primeiro Se o número ainda estiver logado no WhatsApp do celular, o aplicativo pode "consumir" o código antes do SMS — a migração trava. Nesse caso: 1. No celular, abra o WhatsApp do número → Configurações → Conta → Apagar conta (ou deslogar) somente do número que está migrando; 2. Peça um novo código na Meta e confirme. Depois disso, o número não volta para o app — ele já é da API Oficial. 6. Verificação em duas etapas (PIN): se o número já tinha um PIN de duas etapas no WhatsApp Business, a Meta pode pedir esse PIN. Confirme para liberar o número. Como saber que deu certo: o número aparece em Números de telefone da WABA com status verificado e o celular do número não atende mais (o app do WhatsApp saiu). Parte 3 — Conectar a WABA no Imobiturbo.OS 1. No Imobiturbo.OS, abra Conexões → API Oficial (Meta) → Conexão. 2. Preencha os 4 dados (veja onde encontrar cada um em WhatsApp API Oficial): - ID do número de telefone (Phone Number ID do seu número migrado); - ID da conta (WABA ID); - Token de acesso (do usuário do sistema); - App Secret (se o app for seu). 3. Clique em Validar e conectar. O cartão mostra o nome e o número conectados. 4. Configure o webhook na Meta (parte 6 do guia da API Oficial). 5. Teste: de outro telefone, envie mensagem para o número migrado — ela deve chegar na Inbox do OS. Mapa de decisão rápido | Sua situação | Caminho | |---|---| | Número já está na WABA e conectado no OS | Nada a fazer ✅ | | Número está no WhatsApp do celular | Parte 2 (migrar) → Parte 3 (conectar) | | Número está em outra WABA (outra conta Meta) | Migre entre WABAs no WhatsApp Manager (mesma lógica: sair do app, código SMS, PIN) antes da Parte 3 | | Número deu "ID não encontrado" no OS | Confirme que ele pertence à WABA que você informou (o Phone Number ID deve ser daquela WABA) | Problemas comuns | O que aconteceu | O que fazer | |---|---| | O código de verificação não chega | Verifique se o WhatsApp do celular ainda está logado (o app consome o código — deslogue/apague o número) e peça novo código. | | "Two-step verification" bloqueou | Informe o PIN antigo do número; se não souber, o gerenciamento de PIN é feito no WhatsApp Manager. | | O número conecta, mas não recebe mensagens no OS | Verifique o webhook: assinou o campo messages? Colocou o App Secret? (veja o checklist) | | A equipe perdeu acesso ao WhatsApp do celular | Era esperado: na API Oficial o atendimento é 100% pelo OS (Inbox/Canvas). Aproveite para comunicar o fluxo novo. | | Mantiver os dois (app + OS) | Não é possível com o mesmo número — a API Oficial remove o número do app. Se precisa do app, mantenha a conexão por QR em vez da API Oficial. | Próximos passos - WhatsApp API Oficial (Meta) — guia completo - Criar templates de mensagem na Meta - All andar do atendimento na Inbox

Pedir Conexão ao Corretor

Pedir Conexão ao Corretor O Imobiturbo.OS permite que administradores gerem um link seguro e temporário para que cada corretor conecte seu próprio número de WhatsApp sem precisar de acesso completo às configurações do sistema. Para que serve Permite que corretores autônomos ou equipes externas leiam o QR Code diretamente de seus próprios celulares ou computadores de forma independente e segura. Como fazer 1. Acesse o menu Conexões na barra lateral. 2. Localize o canal atribuído ao corretor e clique no botão Pedir Conexão. 3. Uma janela será aberta exibindo o link seguro gerado para aquela sessão. Modal de Link de Conexão para o Corretor Conexões disponíveis para a equipe 4. Clique em Copiar Link. 5. Envie o link gerado para o corretor responsável via WhatsApp ou e-mail. 6. O corretor abrirá o link no navegador e verá a tela de leitura de QR Code simplificada. 7. O corretor fará a leitura com o WhatsApp do próprio aparelho. O que acontece depois - Assim que o corretor conclui a leitura do QR Code, a sessão é ativada instantaneamente. - O status do canal na sua tela é atualizado automaticamente para 🟢 CONECTADO. - As mensagens do corretor passam a ser sincronizadas e distribuídas conforme a configuração da equipe. Problemas comuns - Link expirou: O link de conexão gerado possui tempo limite de validade por motivos de segurança. Se o corretor demorar para abrir, basta clicar novamente em Pedir Conexão e gerar um novo link. - Corretor conectou o número errado: Caso o corretor leia o código com um número pessoal diferente do corporativo, o administrador pode clicar em Desconectar no painel de Conexões e reenviar o link.

Reconectar e Gerenciar Sessões

Reconectar e Gerenciar Sessões Eventualmente, o aplicativo do WhatsApp no celular pode desconectar uma sessão devido a atualizações do aparelho, economia de bateria ou perda prolongada de sinal de internet. Para que serve Saber identificar e restabelecer rapidamente o status de conexão evita que mensagens de clientes fiquem represadas ou sem resposta. Estados da Conexão - 🟢 CONECTADO: A sessão está ativa e operando normalmente. Mensagens são enviadas e recebidas em tempo real. - 🟡 CONECTANDO / RECONECTANDO: O sistema está tentando restabelecer o contato com o aparelho automaticamente. - 🔴 DESCONECTADO: A sessão foi encerrada no celular ou expirou. É necessário fazer uma nova leitura de QR Code. Gerenciar Sessões e Reconectar Lista de conexões e status Como reconectar 1. Acesse o menu Conexões. 2. Localize o canal que está com aviso de desconexão. 3. Clique no botão Reiniciar Sessão ou Reconectar. 4. Uma nova janela com o QR Code será exibida. 5. Abra o WhatsApp no smartphone, acesse Aparelhos Conectados e leia o novo QR Code. Dicas para manter a conexão estável 1. Evite encerrar o WhatsApp no celular: Não force o fechamento do aplicativo do WhatsApp nas tarefas em segundo plano do celular. 2. Mantenha o aparelho conectado: Certifique-se de que o aparelho não passe dias desligado ou sem bateria. 3. Desative otimização de bateria severa: Em alguns aparelhos Android, adicione o WhatsApp à lista de exceções de economia de bateria. O que acontece depois - Assim que a reconexão for concluída, o sistema processará automaticamente qualquer mensagem que tenha chegado durante a interrupção. Problemas comuns - O status fica em 'Conectando' por muito tempo: Clique em Reiniciar Sessão para forçar a inicialização limpa da instância de conexão.

Central de Conexões

Central de Conexões A Central de Conexões é o painel onde você gerencia os números de WhatsApp e os canais que trazem clientes para o Imobiturbo.OS: WhatsApp por QR, WhatsApp API Oficial (Meta) e os Formulários dos seus anúncios. O que você conecta aqui | Canal | Para que serve | Tutorial | |---|---|---| | Números por QR | Cada corretor conecta o próprio WhatsApp (como o WhatsApp Web) | Conectar por QR Code | | API Oficial (Meta) | Número oficial do WhatsApp Business, sem celular ligado, com templates | WhatsApp API Oficial | | Formulários Meta | Leads dos anúncios do Facebook/Instagram direto no funil | Meta Lead Ads | No painel de Conexões, cada canal por QR é representado por um cartão que exibe: - Nome de identificação do canal. - Número de telefone cadastrado. - Corretor ou administrador responsável pelo número. - Indicador de status em tempo real (🟢 Conectado, 🟡 Conectando ou 🔴 Desconectado). - Total de mensagens processadas hoje e tempo médio de resposta. Central de Conexões Formulários Meta na Central de Conexões Vários Números por Imobiliária No Imobiturbo.OS: - Administradores podem visualizar todos os números conectados da organização. - Corretores visualizam e gerenciam a conexão do seu próprio número de WhatsApp. - Todas as mensagens de todos os canais confluem para a Inbox de acordo com as permissões de atendimento. O que acontece depois Com os números conectados: - As mensagens enviadas pelos clientes chegam instantaneamente no CRM. - As automações e agentes de IA podem ser vinculados a números específicos ou a todos os canais. Próximos passos - Conectar WhatsApp por QR Code - Pedir para o corretor conectar seu número - WhatsApp API Oficial (Meta) - Meta Lead Ads (Formulários de anúncios)