Integração com Asaas

O Asaas é o serviço de cobranças que a OctoSolve usa para gerar PIX, boleto e links de pagamento pelo WhatsApp. Sem ele, o agente consegue agendar mas não cobra nada automaticamente.

São 3 etapas, nesta ordem:

1. Conectar o Asaas (chave + webhook) em Configurações → Pagamentos
2. Ativar a cobrança no agente em Meu Agente → Pagamentos
3. Marcar quais serviços cobram antecipado (em massa ou serviço a serviço)

Se você parar na etapa 1, a conta fica conectada mas o agente ainda não cobra nada. O que faz o agente pedir PIX é a etapa 2 + 3.

Importante: cada cliente da OctoSolve tem a própria conta Asaas (vault per-tenant). Sua chave de API fica armazenada de forma criptografada e isolada da chave de qualquer outro cliente da plataforma. O dinheiro cai direto na sua conta bancária; a OctoSolve não toca nos valores, só facilita o envio da cobrança pelo WhatsApp.

Os webhooks também são per-tenant: cada conta gera o próprio token de autenticação. Se você desconectar e reconectar a conta, o token muda, você precisa atualizar no painel Asaas.

Por que usar?

• Agente gera PIX (QR Code + copia-e-cola) na hora do agendamento
• Cobrança antecipada reduz no-show em até 40%
• Confirmação de pagamento é automática: você não precisa verificar manualmente
• Aceita PIX, boleto bancário e cartão de crédito em até 12x
• Disponível no plano Pro em diante

---

Etapa 1: Conectar o Asaas

Passo 1: Criar conta no Asaas

Se você ainda não tem conta:

1. Acesse asaas.com/criar-conta e cadastre-se gratuitamente
2. Envie os documentos solicitados (CNPJ ou CPF + comprovante de endereço)
3. Aguarde a aprovação (leva 1 a 2 dias úteis)

Asaas é uma fintech brasileira regulada pelo Banco Central. A aprovação é necessária para movimentar dinheiro pela conta.

---

Passo 2: Pegar a chave de acesso (API key)

Depois que sua conta Asaas for aprovada:

1. Faça login em console.asaas.com
2. No menu lateral, vá em Minha Conta → Integrações → API
3. Clique em Gerar chave (ou copie a existente)
4. A chave começa com $aact_ e tem cerca de 190 caracteres

---

Passo 3: Conectar na OctoSolve

1. No menu lateral, vá em Configurações → Pagamentos
2. Cole a chave no campo indicado
3. Escolha o ambiente:
   • Sandbox (testes): ideal para experimentar sem movimentar dinheiro de verdade
   • Produção: cobranças reais que chegam na sua conta
4. Clique em Testar e salvar
5. Se aparecer "Asaas conectado ✅" com seu CPF/CNPJ parcialmente mascarado, deu certo

---

Passo 4: Configurar o webhook (obrigatório)

Webhook é o "aviso automático" que o Asaas manda pra OctoSolve quando um pagamento acontece. Sem ele, o agente não sabe que o cliente pagou e o agendamento fica preso em "aguardando pagamento" para sempre.

Assim que você conectar a conta, a tela mostra a URL do webhook e o token de autenticação que você vai cadastrar no Asaas.

Como cadastrar o webhook no painel Asaas:

1. No painel Asaas, vá em Configurações → Integrações → Webhooks
2. Clique em Adicionar webhook e preencha:
   • Este webhook ficará ativo? → Sim
   • Nome do webhook → OctoSolve (ou o que preferir)
   • URL do webhook → cole a URL que aparece na OctoSolve
   • Token de autenticação → cole o nosso token (não clique em "Gerar Token")
   • Tipo de envio → Não sequencial
3. Na aba Cobranças, marque apenas estes 5 eventos:
   • PAYMENT_RECEIVED: pagamento confirmado
   • PAYMENT_CONFIRMED: pagamento aprovado
   • PAYMENT_OVERDUE: cobrança vencida sem pagamento
   • PAYMENT_REFUNDED: valor devolvido
   • PAYMENT_DELETED: cobrança cancelada
4. Clique em Salvar

Para testar (só em Sandbox), clique em "Gerar cobrança teste (R$ 5,00)" na OctoSolve: um PIX de R$ 5 chega no seu WhatsApp e você vê exatamente a experiência do seu cliente. Em Produção esse botão é bloqueado para não criar cobranças reais desnecessárias.

---

Etapa 2: Ativar a cobrança no agente

Conectar o Asaas não liga a cobrança sozinho. Quem manda o agente pedir PIX é esta etapa.

Passo 5: Ativar em Meu Agente → Pagamentos

1. No menu lateral, vá em Meu Agente → Pagamentos (é uma aba lá em cima, ao lado de Serviços e Base de Conhecimento)
2. Se o Asaas estiver conectado, você verá o card "Cobrança automática via PIX" com o status Desativada e o botão Ativar cobrança
3. Clique em Ativar cobrança e confirme no popup

Ao ativar, a OctoSolve liga automaticamente a coleta de CPF antes do agendamento (o Asaas exige CPF/CNPJ pra gerar o PIX). Você pode revisar isso em Meu Agente → Configuração → Informações do Agendamento.

---

Passo 6: Escolher quais serviços cobram antecipado

Logo após ativar, abre a tela "Configurar cobrança por serviço" com a lista dos seus serviços.

Você tem dois caminhos:

• Em massa (botões no topo): Marcar todos · Sinal 50%, Marcar todos · Integral, ou Não cobrar nada
• Serviço a serviço (na tabela): marque a coluna Cobra? e escolha o Tipo:
  • Sinal %: o cliente paga uma parte antes (ex: 50%) e o restante na hora
  • Integral: o cliente paga 100% antes de confirmar

Quando terminar, clique em Salvar e ativar. (Se preferir decidir depois, use Pular e ativar mesmo assim, nenhum serviço cobra antecipado até você configurar.)

Pronto: a partir daqui, o agente pede PIX antes de confirmar os agendamentos dos serviços que você marcou.

---

Ajustar um serviço depois (cobrança automática por serviço)

Pra ligar, desligar ou mudar a cobrança antecipada de um serviço específico depois:

1. Vá em Meu Agente → Serviços e clique para editar o serviço
2. Role até o bloco 💰 Cobrança automática (só aparece com a cobrança ativada)
3. Marque "Cobra antecipado?"
4. Escolha o Tipo (Sinal % ou Integral) e, no caso de sinal, o % do sinal. A tela já mostra quanto o cliente paga antes e quanto fica pra hora.
5. Salve o serviço

Pra reconfigurar vários de uma vez, use o botão Reconfigurar em massa na seção Serviços dentro de Meu Agente → Pagamentos (abre a mesma tabela do Passo 6).

---

Ajustes da cobrança (Meu Agente → Pagamentos)

Com a cobrança ativada, a aba Meu Agente → Pagamentos mostra todas as configurações abaixo.

Métodos de pagamento

Três switches independentes, ative só os que quiser oferecer:

• Auto-cancelamento (horas): cancela sozinho agendamentos não pagos após X horas. 0 = desligado.

Como cobrar

• Janela de pagamento (minutos): quanto tempo o cliente tem pra pagar antes do horário ser liberado pra outra pessoa. Padrão razoável: 30 min.
• Valor mínimo PIX (R$): cobranças abaixo desse valor não geram PIX (não compensa a tarifa). Padrão: R$ 10.
• Instrução padrão do PIX: texto que aparece pro cliente junto com o PIX.

Regras de cobrança

• Vencimento padrão (dias): padrão 3 dias
• Valor mínimo boleto (R$): boletos abaixo disso não são emitidos (boleto tem tarifa fixa)
• Valor mínimo cartão / link universal (R$)
• Multa por atraso (%) e Juros ao mês (%): aplicados após o vencimento
• Desconto antecipado (%) + Dias antes do vencimento p/ desconto
• Instrução do boleto: texto que aparece no boleto

Notificações ao dono

• Avisar quando cliente pagar e Avisar quando cobrança expirar: chegam no seu WhatsApp pessoal (o número configurado na equipe).

---

Chave PIX de emergência

Essa opção fica no fim da tela de Configurações → Pagamentos (não em Meu Agente).

Ela resolve uma situação rara mas chata: o Asaas sai do ar ou demora pra responder bem na hora em que seu cliente está tentando agendar. Sem o fallback, o agente informa que não conseguiu gerar a cobrança e cancela o pré-agendamento.

Com o fallback ativado: se o Asaas falhar após as tentativas automáticas, o agente envia a sua chave PIX direto no WhatsApp do cliente, pra ele pagar manualmente, sem perder o atendimento.

Para ativar, ligue o toggle "Ativar fallback com chave PIX" e preencha sua chave (CPF, CNPJ, telefone, e-mail ou aleatória).

---

Taxas do Asaas

As taxas de processamento ficam com o Asaas, não com a OctoSolve:

• PIX: ~1% por transação
• Boleto: taxa fixa (~R$ 3)
• Cartão: ~4,99%

Elas aparecem no painel Asaas → Relatórios.

---

Solução de problemas

"Chave inválida" ao conectar: verifique se copiou a chave completa. Ela precisa começar com $aact_. Se não funcionar, gere uma nova no painel Asaas.

Conectei o Asaas mas o agente não cobra: faltou a Etapa 2. Vá em Meu Agente → Pagamentos e clique em Ativar cobrança, depois marque os serviços que cobram antecipado.

Ativei a cobrança mas um serviço específico não pede PIX: esse serviço está com "Cobra antecipado?" desmarcado. Edite o serviço (Meu Agente → Serviços) e ligue no bloco 💰 Cobrança automática.

Asaas não aprovou minha conta: é um processo interno do Asaas. Fale com suporte@asaas.com.

Agendamento fica em "aguardando pagamento" mesmo depois do cliente pagar: o webhook não está chegando. No painel Asaas → Logs do Webhook veja os erros. Se aparecer 401 Unauthorized, o token está errado: desconecte e reconecte na OctoSolve pra gerar um token novo.

Boleto sem os dados do cliente: pra gerar boleto, o agente coleta CPF + endereço completo do cliente final (exigência do Asaas). Se o cliente não quiser passar, o agente sugere pagar no local.

Erro ao gerar cobrança teste em Produção: intencional. Use o ambiente Sandbox para testes.

Limite de requisições (HTTP 429): você fez mais de 10 tentativas de conexão/troca de chave na última hora. Aguarde 1 hora.

---

Trocar de conta Asaas

Se você mudou de CNPJ ou quer usar outra conta Asaas:

1. Clique em Desconectar na tela de Configurações → Pagamentos
2. Refaça a conexão com a nova chave

A OctoSolve detecta a mudança de CPF/CNPJ e limpa automaticamente o cadastro de clientes vinculados à conta antiga, assim as próximas cobranças vão para a conta certa.

---

Exclusão de dados (LGPD)

Quando você deleta um contato do painel OctoSolve:

1. Cobranças pendentes são canceladas no Asaas automaticamente
2. O cadastro do cliente no Asaas é removido (ou mascarado com "Cliente removido LGPD" se houver histórico regulatório)
3. Os dados locais são anonimizados

Sua obrigação como controlador de dados fica coberta.