Frappe

Frappe est un framework open source qui sert de base à tout un écosystème d'applications métier, parmi lesquelles ERPNext, Frappe CRM, Frappe HR et bien d'autres. Grâce à son DocType intégré SMS Settings, le framework propose une passerelle SMS HTTP générique disponible dans toutes les applications basées sur Frappe. seven peut y être connecté sans module supplémentaire.

Configurer l'envoi de SMS

Les étapes suivantes configurent la passerelle SMS livrée avec Frappe pour acheminer les messages via l'API HTTP de seven. La configuration est globale et s'applique à toutes les applications de l'instance Frappe (p. ex. ERPNext, Frappe CRM).

  1. 1

    Ouvrir les SMS Settings

    Dans l'instance Frappe, rechercher SMS Settings dans la barre de recherche globale.

  2. 2

    Saisir l'URL de la passerelle

    Dans le champ SMS Gateway URL, saisir :

    https://gateway.seven.io/api/sms
    Saisir uniquement la partie avant le caractère ?. Frappe ajoute lui-même les paramètres à l'URL.
  3. 3

    Mapper les paramètres

    • Message Parameter : text
    • Receiver Parameter : to
  4. 4

    Ajouter les paramètres statiques

    Ajouter les lignes suivantes sous Static Parameters :

    ParameterValueHeader
    X-Api-KeyLa clé API issue de l'espace client seven✅
    from(optionnel) identifiant d'expéditeur souhaité, p. ex. seven❌
    La case Header de chaque ligne détermine si le paramètre est envoyé comme en-tête HTTP (authentification) ou comme paramètre d'URL (métadonnées du message). Activer également Use POST si Frappe doit appeler la passerelle en POST plutôt qu'en GET.
  5. 5

    Enregistrer et tester

    Enregistrer les paramètres et envoyer un SMS de test à un numéro au format international (p. ex. 491771783130) depuis SMS Center dans ERPNext.

Envoi depuis les applications

Une fois la configuration en place, l'envoi de SMS s'utilise comme suit dans les applications Frappe :

ERPNext

  • Envoi manuel via le SMS Center
  • Envoi en masse depuis les vues de liste (p. ex. contacts, clients, fournisseurs)
  • Notifications automatisées via les règles Notification avec canal SMS

Frappe CRM

Frappe CRM ne propose pas de bouton SMS dédié dans son interface. L'envoi est configuré via le DocType standard Notification de Frappe :

  1. Créer une Notification et choisir comme Document Type CRM Lead ou CRM Deal
  2. Définir l'événement déclencheur (p. ex. New, Value Change, Days Before/After)
  3. Régler Channel sur SMS
  4. Dans le champ Receiver, pointer vers le champ du numéro de téléphone du lead/deal (p. ex. mobile_no)
  5. Le corps du message accepte des variables Jinja telles que {{ doc.lead_name }}
Pour toute question complémentaire, contactez-nous : support@seven.io