--- title: "Celular e API no mesmo número de WhatsApp: como fazer" description: "Na API não oficial, o número segue no celular enquanto a API automatiza. Veja como o sistema enxerga quem respondeu e como pausar o bot quando o humano assume." url: "https://api-wa.me/blog/celular-e-api-mesmo-numero-whatsapp-nao-oficial" language: "pt-BR" og:type: "article" og:site_name: "WAME API" --- [Início](https://api-wa.me/)/[Blog da API do WhatsApp](https://api-wa.me/blog)/Usar o celular e a API no mesmo número (API não oficial): o que funciona Raphael Serafim· Publicado em 28 de setembro de 2026· 8 min de leitura Compartilhar # Usar o celular e a API no mesmo número (API não oficial): o que funciona Na API não oficial, o número segue no celular enquanto a API automatiza. Veja como o sistema enxerga quem respondeu e como pausar o bot quando o humano assume. Copiar para LLM[Ver como Markdown](https://api-wa.me/blog/celular-e-api-mesmo-numero-whatsapp-nao-oficial.md) **Sim, na API não oficial do WhatsApp você usa o celular e a API no mesmo número ao mesmo tempo: a instância entra como um aparelho conectado, e o celular continua funcionando normalmente. O que exige cuidado é a convivência — seu sistema precisa saber quando alguém respondeu pelo celular, para o bot não atropelar o atendente. Isso se resolve com o webhook de mensagens enviadas pelo próprio número, que chegam marcadas com `from_me: true`.** É um cenário muito comum em pequenas e médias empresas: o dono ou a equipe já atende pelo celular, e a automação chega para cuidar do repetitivo — confirmação, horário, segunda via, primeira triagem. Ninguém quer trocar de número nem abandonar o app. Este guia mostra como montar esse convívio sem mensagem duplicada e sem o bot respondendo em cima de uma conversa humana. ## Por que funciona na API não oficial A instância da API não oficial se conecta ao número do mesmo jeito que o WhatsApp Web: você escaneia o QR Code (ou digita um código de pareamento) em **Aparelhos conectados**. A partir daí, o número tem dois "aparelhos" ativos — o celular e a instância — e os dois enxergam as mesmas conversas. Na prática: - Mensagem que a API envia aparece no celular, na conversa certa. - Mensagem que o cliente manda chega no celular **e** no webhook da API. - Mensagem que o atendente digita no celular pode chegar ao seu sistema, se você pedir. > A camada não oficial da WAME não é afiliada, endossada ou suportada pelo WhatsApp ou pela Meta. O uso é de responsabilidade de quem envia. Na API oficial, esse convívio tem nome próprio — **Coexistência** — e regras específicas; o assunto está em [API oficial sem perder o celular](https://api-wa.me/blog/whatsapp-api-oficial-manter-no-celular). Na não oficial, ele é o estado natural da conexão. ## Passo 1: receba também o que sai pelo celular Por padrão, o que interessa ao bot são as mensagens que chegam. Para enxergar o que a equipe responde pelo celular, configure também o `webhookMessageFromMe`: bash Copiar ``` curl -X PUT "https://us.api-wa.me/SUA_KEY/instance" \ -H "Content-Type: application/json" \ -d '{ "allowWebhook": true, "allowNumber": "all", "webhookMessage": "https://seu-servidor.com/webhook/wame", "webhookMessageFromMe": "https://seu-servidor.com/webhook/wame", "webhookFormat": "meta" }' ``` As mensagens enviadas pelo próprio número chegam no mesmo envelope das recebidas, com uma diferença: o campo `from_me: true`. Isso vale para o que o atendente digitou no celular e também para o que a própria API enviou — o que é ótimo para auditoria, mas exige um cuidado que veremos no passo 3. Apontar os dois webhooks para a mesma URL simplifica: um só handler, que decide pelo `from_me`. ## Passo 2: separe as três origens No seu handler, toda mensagem cai em uma de três categorias: javascript Copiar ``` function classificar(body, idsEnviadosPeloBot) { const msg = body?.entry?.[0]?.changes?.[0]?.value?.messages?.[0]; if (!msg) return null; if (!msg.from_me) return { origem: 'cliente', msg }; // Eco de mensagem enviada pelo próprio número. if (idsEnviadosPeloBot.has(msg.id)) return { origem: 'bot', msg }; // from_me que o bot não enviou: alguém respondeu pelo celular. return { origem: 'humano', msg }; } ``` A chave está em guardar os ids das mensagens que o bot enviou. A resposta do envio traz o id da mensagem no campo `id`; registre-o num conjunto (ou no Redis, com expiração de algumas horas). Quando o eco chega com `from_me: true`, você sabe que foi o bot. Qualquer outro `from_me` foi uma pessoa. Em 1:1, o `from` do eco identifica a conversa. Em grupo, use o `group_id`, que só aparece quando a mensagem é de grupo. ## Passo 3: pause o bot quando o humano assume A regra que evita quase toda trapalhada é simples: **se um humano respondeu naquela conversa, o bot sai de cena por um tempo.** javascript Copiar ``` const pausas = new Map(); // conversa → até quando o bot fica calado const PAUSA_MS = 2 * 60 * 60 * 1000; // 2 horas, ajuste ao seu atendimento app.post('/webhook/wame', async (req, res) => { res.sendStatus(200); const item = classificar(req.body, idsEnviadosPeloBot); if (!item) return; const conversa = item.msg.group_id ?? item.msg.from; if (item.origem === 'humano') { pausas.set(conversa, Date.now() + PAUSA_MS); return; } if (item.origem === 'bot') return; // eco do próprio bot: ignore const pausadoAte = pausas.get(conversa) ?? 0; if (Date.now() < pausadoAte) return; // humano no comando await responderComBot(item.msg); }); ``` Três detalhes que fazem diferença: - **Ignorar o eco do bot** evita o loop clássico, em que o bot lê a própria resposta como se fosse do cliente. - **A pausa renova a cada resposta humana.** Enquanto o atendente conversa, o bot continua calado. - **Em produção, guarde a pausa num lugar persistente** (banco ou Redis). Um `Map` em memória some no restart, e o bot volta a falar no meio de uma conversa humana. Se preferir um controle explícito, combine uma palavra que o atendente digita para devolver a conversa ao bot — por exemplo, uma mensagem que comece com `#bot` — e trate isso no mesmo handler. ## Passo 4: use etiquetas para a equipe enxergar o estado Quem atende pelo celular não vê o seu banco de dados. Mas vê etiquetas. Se o número usa o WhatsApp Business, as etiquetas criadas pela API são sincronizadas com o app: bash Copiar ``` # Criar a etiqueta (uma vez) curl -X POST "https://us.api-wa.me/SUA_KEY/labels" \ -H "Content-Type: application/json" \ -d '{ "name": "Precisa de humano", "color": 1 }' # Marcar a conversa quando o bot passa a vez curl -X POST "https://us.api-wa.me/SUA_KEY/labels/ID_DA_ETIQUETA" \ -H "Content-Type: application/json" \ -d '{ "to": "5511999999999" }' # Tirar a marca quando resolver curl -X DELETE "https://us.api-wa.me/SUA_KEY/labels/ID_DA_ETIQUETA/chat/5511999999999" ``` Assim o fluxo fica visível no próprio celular: o bot triou, marcou "Precisa de humano", o atendente filtra por essa etiqueta e responde. Mais ideias em [labels na API do WhatsApp](https://api-wa.me/blog/labels-api-whatsapp-organizar-conversas-sem-crm). ## Passo 5: cuide do "lido" Quando a API marca uma mensagem como lida, o cliente vê os tiques azuis — e o atendente, no celular, vê a conversa como lida também. Isso pode esconder uma conversa que ninguém humano olhou. Se a equipe usa "não lidas" como fila de trabalho, deixe a leitura automática desligada na instância e marque como lido só o que o bot resolveu de fato. A leitura é configurada com o parâmetro `markMessageRead` no `PATCH /{key}/instance`, e uma conversa pode voltar a ficar como não lida com `PATCH /{key}/chat` usando a ação `markRead` com valor `false`. ## Como fica o dia a dia Um fluxo típico numa loja ou clínica: 1. Cliente escreve às 22h. O bot responde, tira dúvidas simples e agenda. 2. Cliente pede algo fora do roteiro. O bot avisa que um atendente vai responder e marca a etiqueta. 3. De manhã, a atendente abre o celular, filtra a etiqueta e responde. 4. O webhook recebe a resposta dela com `from_me: true`, e o bot pausa naquela conversa. 5. Resolvido, a atendente tira a etiqueta. Na próxima mensagem do cliente, depois da pausa, o bot volta a atender. Ninguém trocou de número, ninguém instalou painel novo e o cliente nunca recebeu duas respostas. ## Quando partir para multiatendimento O convívio celular + API funciona muito bem com uma ou duas pessoas atendendo. Quando a equipe cresce, um celular só vira gargalo: todo mundo querendo o mesmo aparelho, sem saber quem está falando com quem. Aí vale um painel com vários atendentes no mesmo número, atribuição de conversa e transferência — o desenho está em [vários atendentes no mesmo número](https://api-wa.me/blog/multiatendimento-mesmo-numero-whatsapp), e há integração pronta com o [Chatwoot](https://api-wa.me/blog/integrar-wame-api-chatwoot). ## E o risco de bloqueio? Um número usado por gente de verdade e por um bot que responde quem escreveu é o perfil mais saudável que existe. Na WAME, cada envio da API já sai com tempo humano — online, "digitando…" proporcional ao texto, envio —, então a resposta automática não destoa das respostas da equipe. Com esse uso, a taxa de bloqueio é muito baixa. O que continua sendo risco é o de sempre, e a WAME não apoia: mandar para quem não pediu, repetir a mesma mensagem para muita gente, volume fora do padrão. Os detalhes estão em [o que realmente derruba um número](https://api-wa.me/blog/api-whatsapp-nao-oficial-bane-o-que-derruba-numero). ## Conclusão Celular e API convivem no mesmo número desde o primeiro minuto na API não oficial, porque a instância é só mais um aparelho conectado. O trabalho está em fazer o sistema enxergar a equipe: receber as mensagens com `from_me: true`, separar o eco do bot da resposta humana e pausar o bot na conversa em que alguém assumiu. Com etiquetas e um cuidado com o "lido", a equipe continua atendendo pelo app e a automação cuida do resto. A referência dos webhooks está na [documentação](https://api-wa.me/docs), e o panorama geral em [vantagens da API não oficial](https://api-wa.me/blog/api-whatsapp-nao-oficial-vantagens). ### Pronto para automatizar seu WhatsApp? Crie sua conta gratuita e comece a enviar mensagens pela API em minutos. [Começar grátis](https://portal.api-wa.me/sign-up) ## Perguntas frequentes Posso usar o mesmo número no celular e na API não oficial?+ Sim. A instância entra como um aparelho conectado, igual ao WhatsApp Web. O celular continua funcionando normalmente, e as conversas aparecem nos dois lados: o que a API envia aparece no celular e o que alguém responde pelo celular pode ser avisado ao seu sistema. Como meu sistema fica sabendo que alguém respondeu pelo celular?+ Configure o webhookMessageFromMe com PUT /{key}/instance. As mensagens enviadas pelo próprio número, inclusive as digitadas no celular, chegam no webhook com from\_me: true. Como faço o bot parar quando um atendente assume a conversa?+ Quando chegar uma mensagem com from\_me: true que não foi enviada pelo seu bot, marque aquele chat como em atendimento humano e faça o bot ignorar as próximas mensagens do cliente por um tempo. Para distinguir, guarde os ids das mensagens que o bot enviou. Qual a diferença para a Coexistência da API oficial?+ A Coexistência é o recurso da API oficial (Cloud API) que permite manter o WhatsApp Business app no celular junto com a API. Na API não oficial esse convívio é natural desde o início, porque a instância é só mais um aparelho conectado ao número. Usar celular e API juntos aumenta o risco de bloqueio?+ Não por si só. Um número usado por pessoas e por um bot que responde quem escreveu tem cara de atendimento real. O que aumenta o risco é o de sempre: mensagem para quem não pediu, volume anormal e a mesma mensagem para muita gente. ## Continue lendo [### Agente de voz no WhatsApp: latência, interrupção (barge-in) e silêncio Como deixar um agente de voz no WhatsApp natural: latência, streaming, detecção de fala, interrupção (barge-in), silêncio e eco, com exemplos em Node.js.](https://api-wa.me/blog/agente-voz-whatsapp-latencia-interrupcao)[### Anti-detecção na API não oficial do WhatsApp: como a WAME protege seu número Como funciona a camada de anti-detecção da API não oficial da WAME: identidade de dispositivo, tempo humano, ritmo de envio, reconexão e monitor de saúde.](https://api-wa.me/blog/anti-deteccao-api-whatsapp-nao-oficial)[### API do WhatsApp em C# (.NET): enviar mensagens e receber webhook Tutorial de API do WhatsApp em C# e .NET: HttpClient tipado, envio de texto, imagem e lista, webhook em ASP.NET Core com fila em background e tratamento de 429.](https://api-wa.me/blog/api-whatsapp-csharp-dotnet) [Voltar ao blog](https://api-wa.me/blog) ## Structured data ```json { "@context": "https://schema.org", "@type": "WebSite", "name": "WAME API", "alternateName": "API Oficial e Não Oficial de WhatsApp, Instagram, Messenger e Telegram", "url": "https://api-wa.me", "inLanguage": "pt-BR", "publisher": { "@id": "https://api-wa.me/#organization", "@type": "Organization", "name": "WAME API", "url": "https://api-wa.me" } } { "@context": "https://schema.org", "@type": "Organization", "@id": "https://api-wa.me/#organization", "name": "WAME API", "alternateName": [ "WAME", "Wame API", "wame.api.br", "api-wa.me" ], "url": "https://api-wa.me", "logo": { "@type": "ImageObject", "url": "https://api-wa.me/images/web-app-manifest-512x512.png", "width": 512, "height": 512 }, "disambiguatingDescription": "WAME API é uma empresa brasileira de software, fundada em 2017 e parceira oficial da Meta (Meta Business Partner), que fornece APIs de WhatsApp, Instagram Direct e Messenger. Não tem relação com o wa.me, que é o encurtador de links operado pela WhatsApp LLC.", "identifier": { "@type": "PropertyValue", "propertyID": "INPI-BR", "name": "Pedido de registro de marca (INPI, classe NCL 42)", "value": "944724159" }, "foundingDate": "2017", "slogan": "Parceira Oficial da Meta — WhatsApp, Instagram, Messenger e Telegram numa instância só. Desde 2017.", "description": "Plataforma brasileira e Parceira Oficial da Meta (Meta Business Partner) para as APIs oficiais de WhatsApp (Cloud API), Instagram Direct e Messenger — os três numa única instância, com os mesmos endpoints e um único formato de webhook. Também oferece a API não oficial via QR Code e o Telegram, na mesma plataforma. No mercado desde 2017, com mais de 50 mil instâncias criadas, 99,9% de uptime e suporte humano 24/7 em português. SDKs oficiais para Node.js/TypeScript e PHP.", "knowsAbout": [ "WhatsApp Cloud API oficial (Meta)", "API oficial de Instagram (Direct)", "API oficial de Messenger", "API multicanal Meta", "Meta Business Partner", "WhatsApp API", "API não oficial de WhatsApp", "automação de WhatsApp", "números virtuais", "webhooks" ], "sameAs": [ "https://github.com/wame-api", "https://www.linkedin.com/company/wameapi", "https://www.instagram.com/wame.api/", "https://www.youtube.com/@wameapi" ], "contactPoint": { "@type": "ContactPoint", "contactType": "customer support", "url": "https://api-wa.me/contact", "availableLanguage": [ "Portuguese" ] } } { "@context": "https://schema.org", "@type": "BlogPosting", "headline": "Usar o celular e a API no mesmo número (API não oficial): o que funciona", "description": "Na API não oficial, o número segue no celular enquanto a API automatiza. Veja como o sistema enxerga quem respondeu e como pausar o bot quando o humano assume.", "image": "https://api-wa.me/blog/celular-e-api-mesmo-numero-whatsapp-nao-oficial/opengraph-image", "datePublished": "2026-09-28", "dateModified": "2026-09-28", "author": { "@type": "Person", "name": "Raphael Serafim", "url": "https://github.com/raphaelvserafim", "sameAs": [ "https://github.com/raphaelvserafim" ] }, "publisher": { "@type": "Organization", "name": "api-wa.me", "logo": { "@type": "ImageObject", "url": "https://api-wa.me/images/screenshot.png" } }, "mainEntityOfPage": { "@type": "WebPage", "@id": "https://api-wa.me/blog/celular-e-api-mesmo-numero-whatsapp-nao-oficial" }, "keywords": "api whatsapp não oficial, api não oficial whatsapp, usar whatsapp no celular e na api, mesmo número whatsapp api e celular, bot e atendente mesmo número whatsapp, pausar bot whatsapp quando humano responde, webhook mensagem enviada pelo celular", "inLanguage": "pt-BR" } { "@context": "https://schema.org", "@type": "BreadcrumbList", "itemListElement": [ { "@type": "ListItem", "position": 1, "name": "Home", "item": "https://api-wa.me" }, { "@type": "ListItem", "position": 2, "name": "Blog da API do WhatsApp", "item": "https://api-wa.me/blog" }, { "@type": "ListItem", "position": 3, "name": "Usar o celular e a API no mesmo número (API não oficial): o que funciona", "item": "https://api-wa.me/blog/celular-e-api-mesmo-numero-whatsapp-nao-oficial" } ] } { "@context": "https://schema.org", "@type": "FAQPage", "mainEntity": [ { "@type": "Question", "name": "Posso usar o mesmo número no celular e na API não oficial?", "acceptedAnswer": { "@type": "Answer", "text": "Sim. A instância entra como um aparelho conectado, igual ao WhatsApp Web. O celular continua funcionando normalmente, e as conversas aparecem nos dois lados: o que a API envia aparece no celular e o que alguém responde pelo celular pode ser avisado ao seu sistema." } }, { "@type": "Question", "name": "Como meu sistema fica sabendo que alguém respondeu pelo celular?", "acceptedAnswer": { "@type": "Answer", "text": "Configure o webhookMessageFromMe com PUT /{key}/instance. As mensagens enviadas pelo próprio número, inclusive as digitadas no celular, chegam no webhook com from_me: true." } }, { "@type": "Question", "name": "Como faço o bot parar quando um atendente assume a conversa?", "acceptedAnswer": { "@type": "Answer", "text": "Quando chegar uma mensagem com from_me: true que não foi enviada pelo seu bot, marque aquele chat como em atendimento humano e faça o bot ignorar as próximas mensagens do cliente por um tempo. Para distinguir, guarde os ids das mensagens que o bot enviou." } }, { "@type": "Question", "name": "Qual a diferença para a Coexistência da API oficial?", "acceptedAnswer": { "@type": "Answer", "text": "A Coexistência é o recurso da API oficial (Cloud API) que permite manter o WhatsApp Business app no celular junto com a API. Na API não oficial esse convívio é natural desde o início, porque a instância é só mais um aparelho conectado ao número." } }, { "@type": "Question", "name": "Usar celular e API juntos aumenta o risco de bloqueio?", "acceptedAnswer": { "@type": "Answer", "text": "Não por si só. Um número usado por pessoas e por um bot que responde quem escreveu tem cara de atendimento real. O que aumenta o risco é o de sempre: mensagem para quem não pediu, volume anormal e a mesma mensagem para muita gente." } } ] } ```