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.

Importante: cada cliente usa a própria conta Asaas. 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.

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

---

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 — o agendamento fica preso em "aguardando pagamento" para sempre.

Assim que você conectar a conta, a tela mostrará dois valores:

• URL do Webhook — endereço que você vai cadastrar no Asaas
• Token de autenticação — senha secreta que garante que só o Asaas consegue enviar avisos

Como cadastrar o webhook no painel Asaas:

1. No painel Asaas, acesse Integrações → Webhooks (em algumas versões: Notificações → Webhooks)
2. Clique em Novo webhook
3. No campo URL, cole a URL que aparece na OctoSolve
4. No campo Token de autenticação (ou cabeçalho asaas-access-token), cole o token
5. Marque os seguintes 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
6. Clique em Salvar

Após salvar, você pode testar clicando 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.

---

Métodos de pagamento disponíveis

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

Se um método estiver desativado e o cliente pedir, o agente sugere os métodos ativos.

---

Chave PIX de emergência

Essa opção fica no final da tela de Configurações → Pagamentos.

Ela resolve uma situação rara mas chata: o Asaas tira do ar ou demora para responder na hora em que seu cliente está tentando agendar. Sem o fallback, o agente simplesmente 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 sua chave PIX diretamente no WhatsApp para o cliente conseguir pagar manualmente — sem perder o atendimento.

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

---

Regras e ajustes opcionais

Na mesma tela de Configurações → Pagamentos, você pode ajustar:

• Vencimento padrão — dias para a cobrança vencer. Padrão: 3 dias
• Valor mínimo para boleto — o boleto tem taxa fixa (~R$ 3), então cobranças pequenas podem não valer a pena. Padrão: R$ 15
• Valor mínimo para PIX / cartão — sem piso por padrão, já que são percentuais sobre o valor
• Multa por atraso — % cobrado após o vencimento. Padrão: 2%
• Juros ao mês — % proporcional após vencimento. Padrão: 1%
• Desconto antecipado — % de desconto se o cliente pagar X dias antes do vencimento
• Instrução — texto que aparece no boleto ou PIX. Ex: "Pilates Studio Equilíbrio — studioequilibrio.com"

---

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 chave no painel Asaas.

Asaas não aprovou minha conta — isso é um processo interno do Asaas. Entre em contato com suporte@asaas.com.

Agendamento fica em "aguardando pagamento" mesmo depois do cliente pagar — o webhook não está chegando. Vá no painel Asaas → Logs do Webhook e veja os erros. Se aparecer 401 Unauthorized, o token está incorreto — desconecte e reconecte a conta na OctoSolve para gerar um token novo.

Boleto sem os dados do cliente — para gerar boleto, o agente coleta CPF + endereço completo do cliente final (exigência do Asaas). Se o cliente não quiser passar esses dados, 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 uma conta Asaas diferente:

1. Clique em Desconectar na tela de Pagamentos
2. Refaça o onboarding 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.