Como integrar o Nexo com seu CRM

Como integrar o Nexo com seu CRM

Se sua escola já usa um CRM para acompanhar famílias, negociações de renovação ou o funil de matrícula, agora dá para o Nexo alimentar esse CRM automaticamente: toda cobrança, confirmação de pagamento, aniversário ou falta pode virar uma atualização, uma tarefa ou um card novo no seu CRM, sem ninguém digitar nada.

Em uma frase: o Nexo manda os eventos por webhook; o caminho mais simples até o seu CRM é o Zapier ou o Make, que já sabem conversar com a maioria dos CRMs do mercado.

Por que não "direto"?

A maioria dos CRMs (RD Station, HubSpot, Pipedrive, ActiveCampaign...) não aceita um webhook genérico de fora pronto para virar contato/negociação automaticamente — cada um tem seu próprio formato de API. O jeito prático, sem escrever código, é usar o Zapier ou o Make (antigo Integromat) como ponte: eles recebem o webhook do Nexo e já têm a ação certa pronta para o seu CRM específico (ex.: "Criar ou atualizar contato" no RD Station, "Criar negócio" no HubSpot).

Passo 1 — Configurar no Nexo

• Vá em Admin → Webhooks.
• Cole a URL que o Zapier/Make vai te dar no passo 2 (ainda vazio? volte aqui depois).
• Marque os eventos que fazem sentido para o seu CRM — geralmente Confirmação de pagamento (para marcar cliente ativo) e Cobrança (para acionar o time comercial em atrasos).
• Salve, gere o secret e ative o webhook (mesmos passos do artigo Como conectar o Nexo ao n8n, que também explica o formato do payload recebido).

Passo 2A — Usando Zapier

• Crie um Zap novo com trigger Webhooks by Zapier → Catch Hook.
• Copie a URL gerada pelo Zapier e cole em Admin → Webhooks (Passo 1).
• Dispare um evento de teste (ex.: marque uma falta) para o Zapier capturar o formato dos dados.
• Adicione a ação do seu CRM: no RD Station, "Create or Update Contact"; no HubSpot, "Create or Update Contact" ou "Create Deal"; no Pipedrive, "Create Activity" ou "Update Deal".
• Mapeie os campos: data.student_name → nome, data.guardian_phone → telefone, data.amount → valor, event_type → uma tag ou campo customizado para você filtrar depois.

Passo 2B — Usando Make

• Crie um cenário novo com o módulo Webhooks → Custom webhook.
• Copie a URL gerada e cole em Admin → Webhooks (Passo 1).
• Rode "Run once" no Make e dispare um evento de teste no Nexo para o Make aprender o formato.
• Encadeie o módulo do seu CRM (a maioria dos CRMs populares tem módulo nativo no Make) e mapeie os mesmos campos do exemplo acima.

O formato do evento (para mapear os campos)

Todo evento chega como um POST com este formato — os mesmos campos em Zapier, Make ou qualquer outro receptor:

• event_type: absence, payment_reminder, payment_confirmation ou birthday.
• organization_id: identifica sua escola.
• occurred_at: quando aconteceu.
• data: detalhes do evento — nome do aluno, telefone do responsável, valor, atividade, e um texto sugerido (suggested_message).

Segurança: o header X-Nexo-Signature

Todo POST chega com um header X-Nexo-Signature assinado com o secret que você gerou em Admin → Webhooks. Zapier e Make não validam isso automaticamente — se seu CRM guarda dados sensíveis, vale adicionar um passo de validação (no Make, um módulo de script; no Zapier, um step de "Code by Zapier") antes de deixar o evento seguir para o CRM. Na dúvida, comece só recebendo os eventos e valide depois, quando a automação já estiver rodando do jeito que você quer.

Já usa um CRM sem integração pronta no Zapier/Make?

Se o seu CRM tiver uma API própria de importação e alguém no seu time souber configurar requisições HTTP, o Zapier e o Make também têm um módulo genérico "Webhook"/"HTTP" de saída — ele recebe o evento do Nexo e repassa para a API do seu CRM no formato que ela espera. Nesse caso, vale conversar com quem cuida da tecnologia do seu CRM para saber o formato exato que ele aceita.