Das Erste, was Entwickler tun, wenn sie eine automatische E-Mail brauchen: Sie öffnen die REST-Referenz und suchen nach einer Sendemethode. Es gibt keine. Diese eine fehlende Methode schickt Leute auf zwei falsche Wege — ein Szenario in einer externen Plattform bauen für etwas, das ein Workflow in einem Block erledigt, oder die eingebaute Aktion für kaputt halten, wenn sie sich still weigert zu laufen. Beides lässt sich vermeiden, sobald klar ist, wo der Versand tatsächlich stattfindet.

Gibt es eine REST-API-Methode zum E-Mail-Versand?

Nein. In Bitrix24 (Alaio) verwaltet die Familie mailservice.* E-Mail-Dienste — anlegen, ändern, auflisten, löschen — und die Webmail-Methoden verwalten Postfächer, Nachrichten und Empfänger. Nichts davon bringt eine Nachricht auf den Weg. Ein Postfach anbinden und senden sind Oberflächen-Operationen, keine API-Operationen.

crm.activity.add ist die Methode, die man als Nächstes findet und falsch liest. Sie schreibt eine ausgehende E-Mail-Aktivität in die Timeline, und das ist Buchhaltung: Der Eintrag erscheint in der Kundenkarte, unabhängig davon, ob jemals etwas in einem Postfach ankam. Behandeln Sie das als Protokolleintrag, nicht als Versand.

Es gibt also genau zwei ehrliche Wege, einem Kunden aus der Automatisierung heraus zu schreiben: die eingebaute Aktion im Workflow oder ein HTTP-Aufruf an einen Anbieter, der den Versand für Sie übernimmt. Alles Weitere unten ist eines von beiden.

Wie sendet man eine E-Mail aus einem Workflow?

Die eingebaute Aktion heißt „E-Mail an Kunden senden" und steht sowohl Automatisierungsregeln als auch Geschäftsprozessen zur Verfügung. Sie braucht vier Dinge: eine Absenderadresse (ein konkretes Postfach oder Auto-Auswahl, dann geht die Mail von der Adresse des Verantwortlichen raus), den Adresstyp des Empfängers — geschäftlich, privat, für Newsletter oder Auto-Auswahl —, einen Betreff und einen Text mit eingesetzten Feldwerten.

Drei Bedingungen entscheiden, ob sie überhaupt läuft, und keine davon wirft einen Fehler, den Sie bemerken würden:

Der Verantwortliche muss ein Postfach angebunden haben. Kein Postfach, keine Absenderadresse. Der Adresstyp in der Einstellung muss zu dem passen, was tatsächlich in der Karte steht — wählen Sie „geschäftlich", während nur „für Newsletter" gefüllt ist, verlässt die Mail das Portal nie. Und hängen mehrere Kontakte an einem Auftrag, bekommt nur der erste sie, wobei der Kontakt Vorrang vor dem Unternehmen hat.

Das ist die vollständige Fehlerliste für den Normalfall, und sie erklärt die meisten „die Automatisierung ist kaputt"-Tickets. Welcher Kanal zu welchem Ereignis passt, steht in Benachrichtigungen aus dem Geschäftsprozess; wenn die Regel gar nicht erst anläuft, beginnen Sie bei Automatisierung läuft nicht.

Und SMS?

Gleiche Form, eine zusätzliche Voraussetzung: Das Portal verschickt Textnachrichten nicht selbst. Es übergibt sie einer Anbieter-App aus dem Market, die mit dem Netzbetreiber spricht. Ohne angebundenen Anbieter steht die Aktion in der Liste und tut nichts. Die Nachrichtenlänge ist begrenzt, lange Texte werden also entweder gekürzt oder als mehrere abgerechnet.

Der Telefontyp muss genauso zur Karte passen wie der E-Mail-Typ — wählen Sie „geschäftlich", während nur eine Mobilnummer gespeichert ist, fällt die Nachricht aus. Normalisieren Sie die Nummer vorher mit Telefon mit Ländervorwahl formatieren: Für eine Netzbetreiber-API sind 020 7946 0958 und +44 20 7946 0958 verschiedene Zeichenketten, und eine davon wird nicht zugestellt.

Wie sendet man über den eigenen Anbieter?

Wenn die eingebauten Kanäle nicht reichen — ein Transaktions-Maildienst, ein günstigerer SMS-Aggregator, WhatsApp, Telegram — wird der Versand zu einem ausgehenden HTTP-Aufruf aus dem Workflow heraus. Das ist zugleich die Antwort auf die fehlende REST-Methode: Sie senden nicht über Bitrix24, Sie senden daran vorbei.

Der Roboter HTTP-Anfrage ruft die API des Anbieters auf und gibt Statuscode und Antworttext zurück, sodass der nächste Schritt am Ergebnis verzweigen kann: 200 heißt „gesendet" in die Karte schreiben, alles andere heißt Aufgabe für einen Menschen. Bauen Sie die Nutzlast mit JSON erstellen, statt geschweifte Klammern von Hand zusammenzukleben, und schicken Sie Werte für die Query-Zeichenkette durch URL-Kodierung — sonst zerlegt die erste Adresse mit einem Pluszeichen den Aufruf.

Für Nachrichten, die Sie nicht verlieren dürfen, nehmen Sie Zuverlässiger Webhook: Er wiederholt bei Netzwerkfehlern und 5xx-Antworten mit wachsenden Pausen, statt den Prozess in der ersten schlechten Sekunde fallen zu lassen. Der Unterschied zeigt sich erst im Volumen — ein fünfminütiges Wartungsfenster beim Anbieter kostet Sie sonst jede Nachricht darin. Die Mechanik der Aufrufe in beide Richtungen steht in den Webhooks, das größere Bild in Roboter in Bitrix24 einrichten.

Warum kommen die E-Mails nicht an?

Cloud-Portale haben ein Tageslimit für ausgehende Mails — standardmäßig tausend Nachrichten pro Tag. Eine Kampagne über dem Limit wird nicht abgebrochen: Die ersten tausend gehen raus, der Rest wartet bis morgen. Das Limit bewegt sich: Es steigt, solange Empfänger sich nicht beschweren, und fällt, wenn sie es tun; bei vielen Spam-Meldungen kann der Versand ganz gesperrt werden. Welchen Anteil dieses Kontingents Kampagnen bekommen und welchen die Korrespondenz aus CRM und Postfach, stellen Sie selbst ein.

Drei Konsequenzen, nach denen sich handeln lässt. Legen Sie umsatzkritische Post — Rechnungen, Zugangsdaten, Bestellbestätigungen — nicht auf die Reputation des Portals, sondern auf einen Dienst, dessen Domain Ihnen gehört. Räumen Sie die Liste vor dem Versand auf, nicht danach: Ungültige Adressen erzeugen Bounces, und Bounces drücken das Limit. Und halten Sie die Abmeldung wirklich bei einem Klick — eine Spam-Beschwerde kostet mehr als ein verlorener Abonnent.

Was Sie vor dem Versand an der Liste reparieren

Die Listenqualität entscheidet mehr als der Text. Werfen Sie Karten ohne Adresse mit Feld ist nicht leer raus — sie bekommen ohnehin nichts und verzerren nur die Statistik. Führen Sie Dubletten vorher zusammen: drei identische Mails an eine Person ist der schnellste Weg zur Beschwerde. Die Anrede setzt Geschlecht nach Vorname automatisch, erklärt in Geschlecht nach Vorname. Allgemeine Datenhygiene steht in CRM-Daten bereinigen.

Um eine bestehende Basis in einem Durchgang zu reparieren, nehmen Sie den Massenstart von Geschäftsprozessen: eine Vorlage — Adresse prüfen, Telefon normalisieren, Kennzeichen setzen — über alle Kontakte gefeuert.

Wie es weitergeht

Fangen Sie mit einer einzigen ausgelösten E-Mail an: Ereignis, Bedingung, Versand, die Tatsache des Versands zurück in die Karte schreiben. Wenn sie eine Woche ohne Überraschungen überstanden hat, nehmen Sie SMS zum selben Szenario dazu — und erst danach den Massenversand, wo ein Fehler mit der Größe Ihrer Liste multipliziert wird. Die übrigen Bausteine liegen im Roboter-Katalog: Bedingungen, HTTP-Aufrufe, Werkzeuge für Zeichenketten und Datumsangaben. Und fehlt der Baustein, den Sie brauchen — beschreiben Sie die Aufgabe: Roboteka baut fehlende Aktivitäten kostenlos und stellt sie in die gemeinsame Bibliothek.