Você pode criar uma automação para que, ao cadastrar uma cobrança no Asaas (origem), o Google Gemini (intermediário) padronize o texto da descrição e o Asaas (destino) agende ou emita a nota fiscal com os campos atualizados.
Alertas importantes sobre emissão fiscal:
Os campos Código do serviço municipal e Nome do serviço municipal exigem valores fixos validados pela prefeitura local. Não utilize a inteligência artificial para gerar esses códigos, sob risco de rejeição da nota fiscal. Use a IA apenas para os campos de texto livre (descrição, observações e referência externa).
Alíquotas e códigos municipais devem ser revisados manualmente antes da finalização.
Como configurar a automação:
Faça login na Pluga
2. Na área de usuário, clique em "Criar automatização":
3. Digite um nome para a sua automatização.
4. Selecione o Asaas como ferramenta de origem.
5. Selecione o gatilho Cobrança criada.
6. Clique em Salvar e continuar.
7. Autentique sua conta do Asaas. Caso seja a sua primeira vez conectando o Asaas à Pluga, você pode conferir o tutorial completo acessando https://www.youtube.com/watch?v=poXikBcWPBo
8. Defina se deseja capturar a cobrança de todas as parcelas ou apenas a primeira parcela:
9. Configure filtros adicionais se quiser restringir o disparo (exemplo: capturar apenas cobranças com descrições genéricas).
10. Clique em Conectar Nova Ferramenta.
11. Selecione o Google Gemini e a ação Extrair dados estruturados.
12. Clique em Salvar e continuar.
13. Conecte sua conta inserindo a API Key do Google Gemini. Caso não saiba como encontrar sua API Key, clique em "Veja o passo a passo para encontrar suas chaves de acesso" e siga as instruções.
14. No campo Texto a ser transformado em dados estruturados, clique em Inserir infos e selecione: descrição da cobrança, valor, data de vencimento, forma de pagamento, nome do cliente e ID da cobrança.
15. Selecione o modelo do Google Gemini (recomendado: 2.5 Flash).
16. No campo Instruções de Sistema, insira o prompt de orientação para o especialista em descrições fiscais e comerciais.
Modelo de prompt — Caso 1
Você é um especialista em descrições fiscais e comerciais. Receberá
os dados de uma cobrança recém-criada no Asaas e deve devolver uma
descrição refinada, clara e profissional, pronta para compor a nota
fiscal e ser exibida ao cliente.
Use APENAS as informações fornecidas — não invente serviços, períodos
ou valores que não estejam no input.
Devolva exatamente os campos do schema, sem texto adicional,
comentários ou blocos de código.17. Defina os parâmetros de saída do schema:
serviceDescription: texto até 200 caracteres com a versão limpa do serviço, produto e período.observations: texto até 200 caracteres para o campo de observações da nota fiscal.externalReference: texto até 60 caracteres com identificador padronizado (exemplo: REC-MSN-2025-10) ou o ID da cobrança.
18. Clique em Salvar e continuar.
19. Clique em Conectar Nova Ferramenta.
20. Selecione novamente o Asaas como ferramenta de destino.
21. Escolha a ação Agendar/emitir nota fiscal.
22. Clique em Salvar e continuar e selecione sua conta do Asaas.
23. Defina o critério para buscar um cliente existente no Asaas.
24. Mapeie os campos da nota fiscal clicando em Inserir infos:
Nota fiscal: Descrição dos serviços: mapeie com o parâmetro
serviceDescription.Nota fiscal: Observações: mapeie com o parâmetro
observations.Nota fiscal: Referência externa: mapeie com o parâmetro
externalReference.
25. Clique em Salvar e continuar.
26. Clique em Finalizar automatização.
Para dúvidas sobre a ferramenta de integração, envie um e-mail para suporte@pluga.co.