Quando usar
Você quer anotar um gasto ou uma receita na hora, pelo celular, sem abrir o app. Manda "almoço 45 no cartão" para o bot, confirma, e o lançamento aparece na sua conta.
Antes de começar
- Tenha pelo menos uma conta cadastrada no app. O bot lança na conta marcada como padrão. Se nenhuma for padrão, usa a conta mais antiga.
- Use o número de WhatsApp que vai mandar as mensagens. O bot só aceita mensagens do número vinculado e verificado.
- Tenha o celular com esse WhatsApp por perto: o código de verificação chega nele.
Passo a passo
1. Vincular o número
- No menu lateral, em "Integrações", clique em "Bot WhatsApp".
- Em "Número de WhatsApp (com DDD)", digite seu número com o código do país. Exemplo: +55 11 91234-5678.
- Clique em "Vincular".
O número aparece com o selo "Aguardando verificação" e o bot envia um código de 6 dígitos para esse WhatsApp.
2. Verificar o número
- Abra o WhatsApp no celular e copie o código que chegou.
- Na tela "Bot WhatsApp", digite o código no campo "Código recebido no WhatsApp".
- Clique em "Verificar".
A tela mostra "Número verificado!" e o selo muda para "Verificado". A verificação só funciona com você logado na sua conta, e só quem recebe mensagens nesse número recebe o código. Por isso ninguém consegue ligar o seu número à conta de outra pessoa.
Enquanto o número não estiver verificado, o bot não registra nada. Se você mandar mensagem antes, ele só pede para digitar o código no app.
Em alguns ambientes o bot ainda não envia o código. Nesse caso, a tela mostra uma mensagem no formato VINCULAR 123456: envie essa mensagem ao bot a partir do número vinculado. O bot responde "Número verificado na conta" com o seu e-mail parcialmente escondido. Se o e-mail não for o seu, não envie lançamentos e avise o suporte.
3. Registrar um lançamento
- Envie ao bot uma mensagem com o que foi e o valor:
almoço 45 no cartão→ despesa de R$ 45,00 em Alimentação, no créditomercado 120 pix→ despesa de R$ 120,00 em Mercado, via Pixrecebi 3000 salário→ receita de R$ 3.000,00 em Salário
- O bot responde com o que entendeu e pergunta se pode registrar.
- Responda Sim para registrar ou Cancelar para desistir.
Depois do "Sim", o bot confirma com "registrada!" e o lançamento aparece na conta com a data de hoje.
O que o bot entende
- Valor: o primeiro número da mensagem. Aceita "R$ 32,50", "32,50", "1.234,56" e "reais". Horários como "14h" ou "8h30" não contam como valor.
- Receita ou despesa: vira receita quando a mensagem tem palavras como "recebi", "salário", "renda", "freelance", "bônus", "comissão" ou "dividendo". O resto é despesa.
- Forma de pagamento: "cartão" e "crédito" viram crédito. "débito", "pix" e "dinheiro" também são reconhecidos. Sem nenhuma dessas palavras, o bot assume Pix.
- Categoria: deduzida pelas palavras da mensagem, entre Alimentação, Mercado, Combustível, Transporte, Saúde, Assinaturas, Contas, Salário, Educação, Vestuário e Lazer. Sem pista, fica em "Outros". Você pode ajustar depois no app.
- Confirmar: "sim", "s", "ok", "isso", "confirmar", "confirma" ou "yes".
- Cancelar: "cancelar", "desistir", "esquecer", ou só "não". "não era cartão, foi pix" não cancela.
Limites
- Código de verificação: vale 15 minutos e uma vez só. Depois de 5 tentativas com código errado, peça outro.
- Reenvio do código: dá para pedir outro código a cada 60 segundos. O botão mostra quanto falta ("Reenviar código em 42s"). São no máximo 5 códigos por dia por usuário.
- Um lançamento pendente por vez: se você mandar outro lançamento antes de responder, o bot avisa que já existe um aguardando e não troca pelo novo.
- A confirmação expira em 5 minutos. Passado esse tempo, mande o lançamento de novo.
- Só mensagens de texto: áudio, foto e figurinha são ignorados.
- Um número por usuário, e um número verificado não pode ser vinculado a outra pessoa.
Erros comuns
- "Este número já está vinculado a outra conta." — o número já foi verificado por outro usuário, ou outra conta acabou de receber um código para ele (vale por 15 minutos). Se o número é seu, peça para essa pessoa desvincular ou fale com o suporte.
- "Não conseguimos enviar o código pelo WhatsApp agora." — o envio falhou e nenhum código foi criado. Confira se o número está certo e se tem WhatsApp, espere um pouco e clique em "Reenviar código".
- "Código incorreto. Restam N tentativa(s)." — confira o código no WhatsApp e digite de novo.
- "Este código expirou ou não vale mais." — passaram os 15 minutos, ou você pediu um código mais novo. Clique em "Reenviar código" e use o último que chegar.
- "Muitas tentativas com código errado." — clique em "Reenviar código" e use o código novo.
- "Você atingiu o limite diário de códigos. Tente de novo amanhã." — você já pediu 5 códigos nas últimas 24 horas. Espere e tente de novo.
- "O envio de códigos está temporariamente indisponível. Tente mais tarde." — o envio foi pausado por excesso de pedidos. Tente mais tarde ou fale com o suporte.
- "Aguarde para pedir um novo código." — o último envio foi há menos de 60 segundos. Espere a contagem do botão terminar.
- O bot responde "Seu número não está vinculado a uma conta" — a mensagem saiu de um número diferente do vinculado, ou o número foi desvinculado. Confira o número na tela "Bot WhatsApp".
- O bot responde "Não entendi" — a mensagem não tinha valor. Inclua o número, por exemplo
uber 23. - O bot responde "Nenhuma conta ativa encontrada" — cadastre uma conta no app antes de usar o bot.
Perguntas frequentes
O código não chegou. O que faço? Confira o número mostrado na tela. Se estiver errado, clique em "Desvincular número" e vincule o certo. Se estiver certo, espere a contagem e clique em "Reenviar código".
Eu já usava o bot antes da verificação existir. Preciso verificar? Se o bot já tinha registrado lançamentos seus a partir desse número, ele foi marcado como verificado automaticamente. Se não, a tela mostra "Aguardando verificação": clique em "Reenviar código" e siga o passo 2.
Troquei de número. Como faço? Clique em "Desvincular número", vincule o número novo e verifique de novo.
O que acontece se eu desvincular? O bot para de aceitar mensagens desse número na hora. Os lançamentos já registrados continuam na sua conta.
O bot guarda minhas mensagens? Só o texto das que viram lançamento. O texto que você enviou vira a descrição do lançamento, e o bot guarda um registro com o seu número, o texto da mensagem, o que foi entendido (tipo, valor, categoria e forma de pagamento), o lançamento criado e a data. Esses dados ficam enquanto a sua conta existir. Se você pedir a exclusão da conta, eles são apagados junto com os demais dados na limpeza diária seguinte aos 30 dias do pedido, inclusive os de números que você vinculou antes. O número vinculado e esses registros também vêm no arquivo de "Exportar meus dados", na tela de privacidade.