Documentação
Do primeiro acesso às integrações, em poucos minutos de leitura.
Primeiros passos
Crie sua conta e o workspace da empresa. Ele já vem com um funil de vendas de seis etapas, que você ajusta em Configurações → Funis e etapas.
Convide a equipe em Configurações → Equipe. Papéis: Proprietário (tudo), Administrador (equipe, integrações e configurações), Membro (cria e edita registros) e Leitor (só visualiza).
Importe seus contatos de uma planilha em Contatos → Importar. O Águia reconhece colunas como Nome, E-mail, WhatsApp e Empresa e cria as empresas citadas.
Funil e negócios
Cada negócio vive numa etapa. Arraste o card no quadro para mover; etapas do tipo Ganho e Perdido fecham o negócio (o motivo da perda é pedido na hora).
Adicione produtos a um negócio e o valor passa a ser a soma dos itens. A previsão de fechamento alimenta o relatório de forecast.
Um negócio sem mudar de etapa além do prazo da etapa (padrão: 14 dias) aparece como parado no quadro e no painel.
O Águia usa a API oficial do WhatsApp Business (Cloud API da Meta). Em developers.facebook.com, crie um app, adicione o produto WhatsApp, registre o número e gere um token permanente de usuário do sistema.
Em Configurações → Integrações, informe o Phone Number ID e o token. Copie a URL de callback e o token de verificação para a configuração de Webhook da Meta e assine o campo messages.
Mensagens recebidas criam o contato (quando não existe), abrem a conversa e notificam o responsável. Fora da janela de 24 horas, a Meta exige modelos aprovados.
Conecte o Resend (recomendado) ou qualquer servidor SMTP. O remetente aparece para o cliente; use um domínio verificado.
Para receber respostas na central de conversas, configure o encaminhamento de entrada do provedor para a URL de entrada mostrada na tela.
Automações
Uma automação tem gatilho (quando), condições (se) e ações (então). Exemplo: quando um negócio entrar em Proposta, criar tarefa de follow-up em 2 dias para o responsável.
Ações disponíveis: criar tarefa, adicionar tag, mudar estágio do contato, enviar modelo de mensagem, notificar alguém e definir responsável. Ações feitas por automação não disparam outras automações.
Águia IA
Ative em Configurações → Integrações com uma chave do Vercel AI Gateway (modelos Claude). Cada recurso pode ser ligado ou desligado.
Briefing do dia no painel, análise de negócio e de contato (resumo, temperatura, próximos passos e riscos), rascunho de mensagens e o assistente, que consulta e altera o CRM com as permissões de quem pergunta.
Claude (MCP)
Em Configurações → Conectar ao Claude, crie uma chave e siga as instruções para Claude Code, Claude Desktop ou claude.ai. O endpoint é /api/mcp, com Authorization: Bearer.
As ferramentas são as mesmas da Águia IA: buscar e criar contatos, ver e mover negócios, agendar atividades, notas, conversas, envio de mensagens e resumo de vendas.
Webhooks
Cadastre uma URL em Configurações → Webhooks e escolha os eventos. Cada entrega é um POST JSON com o cabeçalho X-Aguia-Signature (t=timestamp,v1=HMAC-SHA256 de "t.corpo").
Eventos: contact.created, contact.updated, contact.deleted, company.created, company.updated, company.deleted, deal.created, deal.updated, deal.stage_changed, deal.won, deal.lost, deal.deleted, activity.created, activity.completed, message.received, message.sent.