Prendre en main Deskrelance.

Démarrer en 5 minutes

Deskrelance envoie pour vous des relances graduées (WhatsApp, e-mail) sur vos factures impayées, lit les réponses et suit les paiements. Cinq étapes pour être opérationnel :

Le flux

Le parcours est toujours le même : créance → plan → relances → réponses → paiement. Vous définissez le plan une fois ; Deskrelance l'applique à chaque facture, comprend les réponses des clients et enregistre les règlements.

Les parties de Deskrelance — et le besoin de chacune

En une phrase, le besoin que couvre chaque partie :

Statuts d'une facture

Chaque facture suit une machine à états claire. Les relances automatiques ne concernent que les factures actives (et les pauses arrivées à échéance).

Plans & variables

Un plan enchaîne des étapes. Chaque étape définit : le décalage par rapport à l'échéance (négatif = avant, ex. J-3 ; positif = après, ex. J+7), le canal (WhatsApp / e-mail), le niveau (1 rappel courtois → 3 mise en demeure) et le message. La séquence est graduée (une étape par passage) et s'arrête au paiement.

Le message accepte des variables remplacées automatiquement à l'envoi :

{debtor_name}      {debtor_company}   {amount}        {balance} / {amount_due}
{currency}         {invoice_number}   {invoice_title} {issue_date}
{due_date}         {days_overdue}     {payment_link}  {signature}
{pro_name}         {pro_phone}        {pro_email}     {opt_out_link}

{amount} est le total dû ; {balance} (alias {amount_due}) est le restant après acomptes. Une variable inconnue est laissée telle quelle, jamais d'erreur.

Multilingue & réponses

Deskrelance est pensé pour le Maroc : chaque étape peut avoir une version française, arabe et darija. Le message envoyé suit automatiquement la langue du contact ; à défaut de traduction, on retombe proprement sur le français.

Les réponses des clients sont comprises et classées automatiquement, en français, en arabe et en darija (y compris l'écriture latine avec chiffres, « arabizi ») :

Le ton reste maîtrisé (courtois → ferme selon le niveau) et la fréquence est limitée : on relance sans harceler.

Paiement & conformité

Chaque facture peut porter un lien de paiement ({payment_link}) inséré dans les messages. Quand le client règle, vous enregistrez le paiement (total ou acompte) : le solde se met à jour et la facture se solde automatiquement une fois payée.

Opt-out & conformité — sans rien configurer :

• Les e-mails incluent un lien de désinscription ; les WhatsApp invitent à répondre STOP.
• Un « STOP » / « ne plus me contacter » met le contact en opt-out automatiquement — plus aucune relance.
• Conforme à l'esprit de la loi 09-08 (protection des données au Maroc) et du RGPD, et aux règles de WhatsApp Business.

Préférences d'envoi

Depuis Paramètres → Préférences d'envoi, vous contrôlez quand et comment partent les relances automatiques :

Tableau de bord

Le tableau de bord donne l'essentiel du recouvrement d'un coup d'œil :

API & authentification

Deskrelance fonctionne en autonome via son interface, ou intégré : une API REST (JSON) permet à n'importe quel outil (votre logiciel de facturation, un script, un LLM) de piloter le recouvrement. Toute la logique métier est partagée entre l'interface et l'API.

Base URL : https://deskrelance.aiflowhub.online. Authentification par token (un utilisateur dédié par application intégrée, révocable) :

POST /api/auth/token/      → { "token": "9c1f…" }
curl -X POST https://deskrelance.aiflowhub.online/app/api/auth/token/ \
  -d "username=USER&password=PASS"

# puis sur chaque appel :
curl https://deskrelance.aiflowhub.online/app/api/invoices/ \
  -H "Authorization: Token 9c1f…"

Ressources principales (paginées, 25/page ; cloisonnées par organisation) :

Actions sur une facture : POST /api/invoices/<id>/{activate|pause|mark-paid|dispute|send-now}/.

# mettre en pause suite à une promesse de paiement
curl -X POST .../api/invoices/14/pause/ -H "Authorization: Token 9c1f…" \
  -H "Content-Type: application/json" -d '{"until":"2026-07-31"}'

Import en masse

Sans code : onglet Factures → « Importer des factures », fichier CSV ou Excel (.xlsx). Un modèle CSV est téléchargeable. Colonnes reconnues (français ou anglais) :

Par API : POST /api/invoices/import/ (upsert — débiteur rapproché par téléphone, facture par numéro) :

POST /api/invoices/import/
{
  "pro": 1,
  "items": [
    { "debtor": { "name": "Ménara Distrib", "phone_e164": "+212611223344",
                  "email": "[email protected]", "language": "darija" },
      "number": "FAC-0311", "external_ref": "ERP-9982",
      "amount": "28800.00", "currency": "MAD",
      "due_date": "2026-06-28", "title": "Commande juin" }
  ]
}
→ { "pro": 1, "created": 1, "updated": 0, "errors": [] }

language accepte fr, ar, darija, en (et alias « Arabe », « français »…). Une facture créée est activée ; une facture existante est mise à jour sans changer son statut.

Webhooks

Entrants — la passerelle WhatsApp notifie Deskrelance des accusés et des réponses : POST /webhooks/gateway/, signé en HMAC-SHA256 (en-tête X-Webhook-Signature). Événements : message.received, message.status_changed, session.connected/disconnected.

Sortants — Deskrelance notifie votre système source des issues de recouvrement (paiement, promesse, litige, opt-out…). Configurez l'URL de rappel et un secret HMAC au niveau de l'organisation ; chaque envoi est signé (X-Relance-Signature). Un système externe peut aussi déclarer un événement :

POST /api/invoices/declare-event/
{ "event": "invoice.paid", "external_ref": "ERP-9982", "event_id": "evt-123" }
# event ∈ invoice.paid | invoice.partially_paid | invoice.disputed | invoice.canceled
# event_id rend l'appel idempotent (un rejeu n'applique pas deux fois le paiement)

Déploiement & planification

Deskrelance est une application Django. Le moteur de relances est déclenché par une commande à planifier (cron / systemd timer), typiquement chaque heure :

python manage.py migrate
python manage.py run_reminders          # envoie les relances dues
python manage.py run_reminders --dry-run  # affiche sans envoyer

Réglages clés (via variables d'environnement) :

Pour brancher la suite (DeskAssist, Desklink…) ou vos propres outils, voir la page Développeurs.