Wen du erreichst
Lies orbi.project.members. Jede Person hat einen Namen, eine E-Mail-Adresse und eine Rolle. Du kannst nur diesen Personen schreiben. Jede Person bekommt eine eigene E-Mail. Es gibt kein CC.
Eine Nachricht senden
async ({ notifications }) => {
return await notifications.send({
to: "sponsor",
subject: "Run finished",
text: "The goal was reached.",
})
}to: "sponsor" schreibt an den Sponsor. to: "members" schreibt an alle im Workspace. Du kannst auch die Id oder E-Mail eines Mitglieds aus orbi.project.members übergeben. Die Nachricht kommt von app@orbitype.com.
Klartext und eigenes HTML
Klartext wird als HTML im Orbitype-Layout gesendet. Übergib html, wenn du schon HTML hast. Setze layout: false, wenn dieses HTML die ganze Nachricht sein soll.
await notifications.send({
to: "members",
subject: "Update",
html: "Hello
",
layout: false,
})Aus einem Agent
Im Agent-Wizard wählst du Workspace Notification. Es schreibt an den Sponsor, außer du setzt alle Mitglieder. Du gibst keinen SMTP-Host und kein Passwort ein. Übergib origin mit dem Namen des Agents, damit der Posteingang zeigt, wer gesendet hat.
E-Mail, Posteingang und Geräte
Setze channels auf ["email"], ["push"] oder beides. E-Mail ist der Standard. Push speichert die Nachricht auf dem Konto dieser Person, über alle Workspaces, und sendet sie an jeden Browser und jedes Telefon, das sie abonniert hat. Das Gerät, das sie gerade ansieht, zeigt einen Toast und einen kurzen Ton. Die anderen zeigen eine Browser-Benachrichtigung. Ein weiteres Gerät zu abonnieren entfernt die früheren nicht. Jede benachrichtigte Person kostet 1 Credit, auch wenn beide Kanäle genutzt werden. Übergib origin mit einem kurzen Namen, zum Beispiel dem Agent-Namen.
await notifications.send({
to: "sponsor",
subject: "Goal reached",
text: "The run ended.",
origin: "Sales researcher",
channels: ["email", "push"],
})Was fehlschlägt
Eine Adresse, die kein Workspace-Mitglied ist, wird nicht gesendet. Dasselbe gilt für CC, eine andere Absenderadresse und einen Aufruf ohne Betreff.