🔧 Intégrations

---

n8n

Configuration

1. Dans Paramètres (/settings) → section Webhooks
2. Coller l'URL de votre webhook n8n (ex: https://n8n.seb205.ovh/webhook/abc123)
3. Cliquer OK pour sauvegarder dans localStorage

Déclenchements disponibles

Déclencheur	Depuis	Description
Bouton n8n	Mail Analyseur	Lance le workflow avec les headers et le résultat
Icône n8n	Mail Dashboard	Par analyse individuelle dans l'historique
Section n8n	Page Export	Avec URL configurable + formats choisis

Payload envoyé

{
  "timestamp": "2026-04-19T10:00:00.000Z",
  "analysis": {
    "spf": "fail",
    "dkim": "pass",
    "dmarc": "fail",
    "threatLevel": "high",
    "from": "attacker@evil.com",
    "subject": "Votre colis est prêt"
  },
  "exports": {
    "sheets": true,
    "xml": true,
    "json": true,
    "slack": false,
    "calendar": true
  },
  "formats": {
    "json": "{\"spf\":\"fail\",...}",
    "xml": "<?xml version=\"1.0\"...>",
    "csv": "spf,dkim,dmarc\nfail,pass,fail",
    "calendar": "BEGIN:VCALENDAR\n..."
  }
}

Use-cases courants

Alerte Slack si score > 60 :

Webhook n8n reçu → IF score > 60 → POST Slack message

Rapport quotidien :

CRON 08:00 → GET analyses du jour → Aggreger → Email récapitulatif

Workflow PME :

Email entrant → Analyser headers → IF dangereux → Créer ticket Jira + alert Teams

Instance n8n de référence

n8n.seb205.ovh

---

Make.com

Configuration

1. Dans Paramètres → section Webhooks
2. Coller l'URL Make.com (ex: https://hook.eu2.make.com/abc123)
3. Cliquer OK

Payload envoyé

{
  "action": "analyze_spam",
  "timestamp": "2026-04-19T10:00:00.000Z",
  "source": "email-header-analyzer",
  "emailHeaders": "Received: from...",
  "analysisData": {
    "spf": "fail",
    "threatLevel": "high",
    "score": 78
  }
}

Secret optionnel

Si MAKE_AUTH_TOKEN est configuré en secret Supabase, le header X-Auth-Token est ajouté à chaque requête vers Make.com.

---

IPQualityScore

Usage : Score de fraude IP (0-100), détection VPN/Proxy/Tor, abus récent.

Activation : Paramètres → APIs actives → IPQualityScore → ON + saisir clé API

Données retournées :

{
  "fraud_score": 45,
  "country": "FR",
  "isp": "Orange SA",
  "is_vpn": false,
  "is_proxy": false,
  "is_tor": false,
  "recent_abuse": false
}

Limite gratuite : 5 000 req/mois
Lien : ipqualityscore.com

---

AbuseIPDB

Usage : Réputation IP basée sur les signalements communautaires.

Données retournées :

{
  "abuse_confidence_score": 10,
  "country": "FR",
  "isp": "Orange SA",
  "usage_type": "ISP",
  "is_whitelisted": false,
  "total_reports": 2
}

Limite gratuite : 1 000 req/jour
Lien : abuseipdb.com

---

VirusTotal

Usage : Détection malveillante IP par 70+ moteurs antivirus.

Données retournées :

{
  "malicious": 0,
  "suspicious": 1,
  "harmless": 65,
  "undetected": 8,
  "country": "FR",
  "asn": 3215,
  "as_owner": "Orange SA"
}

Limite gratuite : 4 req/min, 500 req/jour
Lien : virustotal.com

---

ARCEP (base numéros)

Source : Projet open-source Saracroche (Codeberg)
URL : https://codeberg.org/cbouvat/saracroche-android/raw/branch/main/app/src/main/assets/french-list-arcep-operators.json
Licence : MIT/GPL (Saracroche) + Licence Ouverte Etalab v2.0 (données ARCEP)

Version actuelle : v2026.02.26.17.26
Taille : 14M+ préfixes
Cache : 1h in-memory dans la Edge Function arcep-check

Mise à jour manuelle : BlocNum Analyseur → bouton MAJ → action refresh

---

Slack (export)

Usage : Export d'une analyse vers un canal Slack.

Payload envoyé (format blocks API Slack) :

{
  "blocks": [
    {
      "type": "header",
      "text": { "type": "plain_text", "text": "📧 BlocMail — Rapport d'analyse" }
    },
    {
      "type": "section",
      "fields": [
        { "type": "mrkdwn", "text": "*SPF:* ❌ fail" },
        { "type": "mrkdwn", "text": "*DKIM:* ✅ pass" },
        { "type": "mrkdwn", "text": "*DMARC:* ❌ fail" },
        { "type": "mrkdwn", "text": "*Menace:* 🔴 HIGH" }
      ]
    }
  ]
}

Configuration : ajouter l'URL du webhook entrant Slack dans la page Export.

---

Intégrations prévues (roadmap)

Intégration	Horizon	Description
Extension Chrome Gmail	Q2 2026	Analyse en un clic depuis Gmail/Outlook
Stripe	Q2 2026	Facturation Freemium/Premium/PME
SendGrid	Q2 2026	Envoi de rapports par email
Zapier	Q4 2026	Connecteur officiel Zapier
Microsoft Teams	Q4 2026	Bot Teams @BlocMail check email
Firebase Cloud Messaging	Q3 2026	Push notifications PWA

Voir ROADMAP.md.