> ## Documentation Index > Fetch the complete documentation index at: https://muveya.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Canal do WhatsApp > O que o canal do WhatsApp do muveya faz, como um membro é vinculado hoje e quais regras o mantêm seguro. O canal do WhatsApp permite que um membro vinculado da equipe faça algumas tarefas diárias de estoque pelo celular, em uma conversa individual com o número de WhatsApp do muveya. É um canal operacional, não um chatbot: oferece um menu fixo, pede um dado por vez, mostra um resumo exato do que vai mudar e só altera o estoque depois que você toca em **Confirmar**. O canal do WhatsApp não faz parte do serviço piloto atual (seção 4 dos [Termos de serviço](https://muveya.com/pt/terms-and-conditions)). Além disso, hoje ele não está ativado no serviço de produção para nenhuma conta de clínica odontológica: esta página descreve como ele funciona. Pergunte a [team@muveya.com](mailto:team@muveya.com) sobre a disponibilidade antes de planejar sua operação com ele. ## O que ele faz hoje | Opção do menu (como é enviada hoje) | O que faz | Altera o estoque | | - | - | - | | **Consultar stock** (Consultar estoque) | Mostra o insumo, o depósito, a quantidade disponível, o lote e a validade de uma caixa. | Não | | **Registrar consumo** | Registra unidades usadas de uma caixa existente. | Sim, depois da confirmação | | **Recibir stock** (Receber estoque) | Recebe uma entrega em uma caixa nova. | Sim, depois da confirmação | | **Ayuda** (Ajuda) | Explica o menu. | Não | Cada passo, mensagem e erro está descrito em [Operações pelo WhatsApp](/docs/pt/whatsapp/operations). Hoje, o canal **não** faz mais nada. Pedidos, aprovações, separação, despacho, entrega e recebimento de entregas, transferências entre depósitos, correções, contagens e relatórios são feitos no console. O canal não responde perguntas em texto livre e não lê fotos, áudios, documentos nem figurinhas: enviar um deles encerra o fluxo em andamento e mostra o menu de novo. ## Como uma conversa funciona ```mermaid theme={null} flowchart LR A[Qualquer mensagem] --> B{Número vinculado?} B -- Não --> C[Aviso de vinculação] B -- Sim --> D[Menu] D --> E[Passos guiados: uma pergunta por vez] E --> F[Cartão de resumo] F -- Confirmar --> G[O muveya registra a operação] G --> H[Comprovante com número da operação] F -- Corrigir --> E F -- Cancelar --> I[Nada muda] ``` * **Determinístico.** O canal age apenas sobre a opção ou o botão que você toca e sobre a sua resposta à pergunta que ele acabou de fazer. Nunca adivinha o que uma mensagem significa, e nenhuma IA participa de nenhum passo. * **Confirmação primeiro.** Nada muda até você tocar em **Confirmar** no cartão de resumo. **Corregir** (Corrigir) leva você de volta para corrigir os dados; **Cancelar** encerra o fluxo sem mudanças. * **As mesmas regras do console.** Ao confirmar, o muveya verifica de novo suas permissões, seus depósitos e o estoque atual, exatamente como no console. * **Um fluxo por vez.** Cada número tem um único fluxo ativo. Iniciar outra opção o substitui. Um fluxo esquece seus dados 10 minutos depois da última resposta que aceitou. * **Sem duplicidade.** Tocar de novo no mesmo botão **Confirmar**, ou o WhatsApp entregar a mesma mensagem duas vezes, nunca registra a operação duas vezes. ## Quem pode usar Qualquer membro ativo de uma conta de clínica odontológica pode vincular o próprio número. O que ele pode fazer pelo chat depende das suas permissões e dos depósitos atribuídos, que o muveya lê de novo a cada mensagem: | Opção | Permissão necessária | Rótulo no console | | - | - | - | | Consultar estoque | `inventory.read` | **Ver estoque** | | Registrar consumo | `inventory.consume`, ou `inventory.adjust`, que a inclui | **Registrar consumo**, ou **Ajustar e contar estoque** | | Receber estoque | `inventory.receive`, ou `inventory.adjust`, que a inclui | **Receber entregas**, ou **Ajustar e contar estoque** | Um membro limitado a alguns depósitos só vê e usa caixas desses depósitos. Um membro sem nenhum depósito não pode registrar consumo nem receber estoque. As permissões são concedidas em **Equipe**; veja [Equipe](/docs/pt/account/team) e [Funções e permissões](/docs/pt/account/roles-and-permissions). ## Vincule seu número de WhatsApp Um número é vinculado com um código de uso único que pertence a você e à conta de clínica odontológica que estava ativa quando o código foi criado. A partir daí, o muveya reconhece as mensagens desse número como suas. Por enquanto, o console não tem uma tela para criar o código de vinculação. Um código só pode ser emitido para você, com a sua sessão iniciada na sua própria conta de clínica odontológica: a equipe do muveya não pode criá-lo em seu nome. Escreva para [team@muveya.com](mailto:team@muveya.com) se quiser usar o canal ou se não souber o número de WhatsApp do muveya. Consiga seu código de uso único como descrito acima. Ele vale por 10 minutos. No celular que você quer vincular, abra uma conversa de WhatsApp com o número do muveya. Se você escrever algo que não é um código, o muveya responde com o aviso de vinculação. Envie os 8 caracteres como mensagem. Maiúsculas, minúsculas e espaços não importam. O muveya confirma a vinculação. A partir daí, qualquer mensagem mostra o menu. As mensagens que você pode ver durante a vinculação (hoje o canal envia a versão em espanhol, veja [Idiomas](#idiomas)): ```text Espanhol (enviado hoje) theme={null} Para operar muveya desde WhatsApp, primero vincula tu cuenta: responde con el código de un solo uso que generaste en la consola. Listo — tu WhatsApp quedó vinculado a muveya. Ya puedes operar desde aquí. Ese código no es válido o expiró. Genera uno nuevo en la consola y envíalo por aquí. ``` ```text Inglês theme={null} To operate muveya from WhatsApp, first link your account: reply with the one-time code you generated in the console. Done — your WhatsApp is now linked to muveya. You can operate from here. That code is not valid or has expired. Generate a new one in the console and send it here. ``` ```text Português theme={null} Para operar o muveya pelo WhatsApp, primeiro vincule sua conta: responda com o código de uso único que você gerou no console. Pronto — seu WhatsApp foi vinculado ao muveya. Você já pode operar por aqui. Esse código não é válido ou expirou. Gere um novo no console e envie por aqui. ``` A primeira mensagem é o aviso de vinculação, a segunda confirma a vinculação e a terceira indica que o código falhou. O aviso menciona o console, mas o console ainda não tem uma tela para criar o código (veja acima). ### Regras do código de vinculação | Regra | Detalhe | | - | - | | Formato | 8 caracteres: letras maiúsculas e dígitos, sem os fáceis de confundir `0`, `1`, `I`, `L` e `O`. | | Validade | 10 minutos a partir da criação. | | Uso único | Um código vincula uma única vez. Um código novo para a mesma pessoa na mesma conta de clínica odontológica cancela qualquer código anterior não usado. | | Mensagem de falha | Um código inválido, expirado ou já usado recebe a mesma resposta, que não diz qual foi o caso. | | O que vincula | Seu vínculo com a conta de clínica odontológica que estava ativa quando o código foi criado. | | Um número, um vínculo | Um número fica associado a um único vínculo. Vincular o mesmo número de novo com um código novo substitui a vinculação anterior. | Enquanto um número está associado a um vínculo ativo, toda mensagem dele é tratada pelo menu ou pela pergunta em andamento, e um código novo nunca é resgatado. Por isso, um número vinculado não pode ser passado para outra pessoa ou outra conta de clínica odontológica enviando um código. Escreva para [team@muveya.com](mailto:team@muveya.com) se precisar disso. ## Desvincular e revogar Por enquanto, não há opção para desvincular nem no chat nem no console. Uma vinculação deixa de funcionar, imediatamente e a partir da próxima mensagem, quando: * o membro é suspenso (**Suspender acesso**) ou removido da conta de clínica odontológica (**Remover da clínica**) em **Equipe**; * o vínculo foi suspenso depois da vinculação do número: mesmo depois de **Reativar acesso**, as vinculações anteriores à suspensão continuam encerradas e a pessoa precisa vincular de novo. Depois disso, as mensagens do número recebem o aviso de vinculação e qualquer fluxo em andamento não pode mais ser continuado; seus dados expiram em no máximo 10 minutos. Ainda não existe uma forma de desvincular um número sem suspender ou remover o membro. Mudanças de permissões ou de depósitos não desvinculam o número: valem a partir da próxima mensagem. Uma permissão retirada durante um fluxo encerra esse fluxo com a resposta de "sem permissão", mesmo no passo de confirmação. ## Idiomas Hoje o canal sempre responde em **espanhol** (neutro latino-americano), qualquer que seja o idioma que o membro usa no console. O produto tem versões em inglês e em português de cada mensagem, e esta documentação as mostra ao lado do texto em espanhol, mas o canal ainda não as seleciona. Por isso os rótulos dos botões e do menu também estão em espanhol: **Confirmar**, **Corregir**, **Cancelar**. ## Privacidade e segurança * **Sem custos, valores ou dados de pacientes.** Nenhuma mensagem contém custos, valores de pedidos ou referências de pacientes ou de atendimento. O canal nunca pede esses dados; não os envie pelo chat. * **O que as mensagens contêm.** Códigos de caixa, nomes e SKUs de insumos, nomes de depósitos, quantidades, números de lote, números de série, datas de validade e números de operação. * **Montadas a partir de registros.** Cada resposta é montada com os registros do muveya e textos fixos; nunca é gerada. * **Seu número.** O muveya guarda o número para reconhecer você. Os registros de auditoria guardam apenas um hash irreversível do número, não o número. * **Memória curta.** O passo em que você está e o seu rascunho ficam guardados por 10 minutos depois da última resposta que o fluxo aceitou. O id de cada mensagem recebida do WhatsApp fica guardado por 24 horas, apenas para descartar duplicidades. * **Origem verificada.** O muveya aceita mensagens recebidas somente quando o seu provedor de WhatsApp as assina; qualquer outra é recusada. * **Os tiques de entrega não são prova.** Os estados enviado, entregue e lido do WhatsApp servem apenas para monitorar o canal. Nunca são registrados como prova de que o estoque foi entregue ou recebido. * **O acesso segue o vínculo.** Um membro suspenso ou removido perde o canal na hora, como descrito acima. Mais informações em [Segurança e privacidade](/docs/pt/trust/security-and-privacy). ## O que o sistema registra | Evento | Registro | | - | - | | Número vinculado | Evento de auditoria `channels.linked` do membro, com um hash do número. | | Consumo confirmado | Um movimento `consume` no registro de movimentos com o membro como autor e motivo `whatsapp`, mais o evento de auditoria `channels.consume_confirmed` com o id do movimento e a quantidade. | | Recebimento confirmado | Uma caixa nova e seu movimento `receive`, mais o evento de auditoria `channels.receive_confirmed` com o id do movimento e a quantidade. | | Estoque consultado | Nada. | O número da operação em cada comprovante é o id do movimento no registro. O mesmo movimento aparece no histórico da caixa no console; veja [Caixas e etiquetas](/docs/pt/inventory/boxes). ## O que pode dar errado | O que você vê | Causa | O que fazer | | - | - | - | | O aviso de vinculação, várias vezes | O número não está vinculado, o vínculo está suspenso ou foi removido, ou a vinculação é anterior a uma suspensão. | Vincule o número de novo com um código novo. O console ainda não consegue criá-lo: escreva para [team@muveya.com](mailto:team@muveya.com). | | **Ese código no es válido o expiró. Genera uno nuevo en la consola y envíalo por aquí.** | O código está errado, tem mais de 10 minutos, já foi usado ou foi substituído por um mais novo. | Obtenha um código novo e envie em até 10 minutos. | | **No tienes permiso para …** | Você não tem a permissão dessa opção, ou não tem depósitos atribuídos. | Peça a alguém com **Gerenciar acesso da equipe** que conceda em **Equipe**. | | Nenhuma resposta | Um problema temporário no WhatsApp ou no muveya. O muveya tenta processar a mensagem de novo automaticamente. | Aguarde um minuto e envie qualquer mensagem para ver o menu. Antes de repetir um consumo ou recebimento, confira a caixa no console para não registrar duas vezes. | Para cada mensagem de cada fluxo, veja [Operações pelo WhatsApp](/docs/pt/whatsapp/operations). ## Páginas relacionadas Cada conversa, pergunta, limite e resposta de erro. Conceda permissões, suspenda ou remova um membro. O recebimento no console, com apresentações e mais opções. Como o muveya protege seus dados. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.