Frappe

Frappe ist ein Open-Source-Framework, das die Basis für ein ganzes Ökosystem an Geschäftsanwendungen bildet, darunter ERPNext, Frappe CRM, Frappe HR und viele weitere. Das Framework liefert mit dem SMS Settings DocType eine eingebaute Anbindung an ein beliebiges HTTP-SMS-Gateway, die in allen Frappe-basierten Apps zur Verfügung steht. seven lässt sich darüber ohne zusätzliches Modul konfigurieren.

SMS-Versand einrichten

Die folgenden Schritte konfigurieren das in Frappe enthaltene SMS-Gateway so, dass Nachrichten über die HTTP-API von seven verschickt werden. Die Einstellungen gelten systemweit für alle Apps der Frappe-Instanz (z.B. ERPNext, Frappe CRM).

  1. 1

    SMS Settings öffnen

    In der Frappe-Instanz über die globale Suche SMS Settings aufrufen.

  2. 2

    Gateway-URL eintragen

    Im Feld SMS Gateway URL den folgenden Wert hinterlegen:

    https://gateway.seven.io/api/sms
    Nur den Teil vor dem ? eintragen. Frappe hängt die Parameter selbst an die URL an.
  3. 3

    Parameter zuordnen

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

    Statische Parameter hinterlegen

    Unter Static Parameters folgende Zeilen anlegen:

    ParameterValueHeader
    X-Api-KeyDer API-Key aus dem seven Kundenbereich✅
    from(optional) gewünschte Absender-ID, z.B. seven❌
    Die Header-Checkbox in der Zeile entscheidet, ob der Parameter als HTTP-Header (Authentifizierung) oder als URL-Query-Parameter (Nachrichten-Metadaten) gesendet wird. Optional zusätzlich Use POST aktivieren, damit Frappe per POST statt GET an die Gateway-URL sendet.
  5. 5

    Speichern und testen

    Die Einstellungen speichern und in ERPNext über SMS Center eine Test-SMS an eine Mobilnummer im internationalen Format (z.B. 491771783130) senden.

Versand aus den Apps

Nach erfolgreicher Einrichtung lässt sich der Versand in den jeweiligen Frappe-Apps wie folgt nutzen:

ERPNext

  • Manueller Versand über das SMS Center
  • Massenversand aus Listen-Ansichten (z.B. Kontakte, Kunden, Lieferanten)
  • Automatisierte Benachrichtigungen über Notification-Regeln mit Channel SMS

Frappe CRM

Frappe CRM enthält keinen eigenen SMS-Button im UI. Der Versand erfolgt über den Frappe-Standard Notification-DocType:

  1. Notification anlegen und als Document Type CRM Lead oder CRM Deal wählen
  2. Auslösendes Ereignis festlegen (z.B. New, Value Change, Days Before/After)
  3. Als Channel den Wert SMS setzen
  4. Im Feld Receiver das Mobilnummer-Feld des Lead/Deal hinterlegen (z.B. mobile_no)
  5. Im Nachrichtentext können Jinja-Platzhalter wie {{ doc.lead_name }} verwendet werden
Bei weiteren Fragen senden Sie uns gerne eine Nachricht: support@seven.io