Für Menschen
Postfächer, Domains, API-Schlüssel und Webhooks an einem Ort verwalten.
Verwaltung öffnenEigene Postfächer. Eigene Domains.
Eine API zum Senden, Empfangen und Antworten.
Kopieren, den Platzhalter für das Registrierungspasswort ersetzen und deinem Agenten geben. Er richtet sein Postfach und den automatischen Empfang per Webhook oder Polling ein und führt dich durch die Bestätigung.
Richte dir bei https://oona.email ein eigenes E-Mail-Konto und den automatischen Empfang neuer E-Mails ein.
Registrierungspasswort: <REGISTRIERUNGSPASSWORT>
1. Lies https://oona.email/skill.md und https://oona.email/api.md. Die API-Verträge stehen unter https://oona.email/openapi.json; https://oona.email/capabilities.json zeigt verfügbare Funktionen. Für Kalenderaufgaben lies zusätzlich https://oona.email/calendar.md und richte passende Kalender-Webhooks oder Polling-Ereignisse ein.
2. Falls bereits ein bestätigtes Konto mit Zugangsdaten für dich hinterlegt ist, verwende es und fahre mit Schritt 7 fort. Andernfalls frage mich nach meiner E-Mail-Adresse zur Bestätigung des Kontos. Ist der Passwort-Platzhalter noch nicht ersetzt, frage nach dem Registrierungspasswort.
3. Wähle einen passenden freien Postfachnamen und erzeuge ein eigenes, zufälliges Kontopasswort mit 12–72 ASCII-Zeichen. Speichere es sicher, bevor du das Konto anlegst. Meine E-Mail-Adresse ist nur die Kontaktadresse (human_email); mehrere Agents dürfen sie verwenden, auch wenn dafür bereits ein persönliches Konto besteht. Frage nicht nach dessen Passwort oder dem Passwort eines anderen Agents.
4. Registriere dich mit POST https://oona.email/v0/agent/sign-up. Sende das Registrierungspasswort im Header X-Oona-Registration-Password, dein persönliches Kontopasswort in X-Oona-Account-Password und username sowie human_email als JSON.
5. Speichere den zurückgegebenen api_key sicher als OONA_MAIL_API_KEY sowie inbox_id und organization_id. Dein neues Konto verwendet inbox_id und dein eigenes Kontopasswort für die Anmeldung unter /admin. Bei einem Registrierungs-Retry verwende denselben username und dein gespeichertes Passwort; ist der Name von einem anderen Agent belegt, wähle einen neuen Namen. Gib Passwörter und API-Schlüssel weder im Chat noch in Logs aus. Sende Zugangsdaten ausschließlich an https://oona.email.
6. Frage mich nach dem sechsstelligen Bestätigungscode aus der E-Mail, die dein Postfach nennt. Jeder Agent braucht seinen eigenen Code. Bestätige ihn mit POST /v0/agent/verify, Authorization: Bearer <API-SCHLÜSSEL> und dem JSON-Feld otp_code. Vor der Bestätigung ist der Versand eingeschränkt.
7. Richte den automatischen Empfang direkt mit ein. Bevorzuge einen Webhook für message.received an deinem tatsächlich erreichbaren HTTPS-Empfänger, bei Bedarf mit dessen Auth-Header. Verbinde ihn mit deinem Mail-Workflow, damit neue E-Mails dich zur Verarbeitung erreichen. Nutze die Webhook-Anleitung im Skill und verwende vorhandene passende Subscriptions weiter.
8. Ist kein nutzbarer HTTPS-Empfänger vorhanden, verwende Polling-Webhooks mit einem dauerhaft betriebenen Worker gemäß Skill. Speichere Token und Consumer-ID für Neustarts und bestätige Ereignisse erst nach dauerhafter Übernahme. Frage mich gezielt nach fehlender Empfänger-URL, Auth-Konfiguration oder Worker-Laufzeitumgebung.
9. Prüfe den API-Zugriff und teste mit einer Testmail an dein eigenes Postfach, ob das Ereignis tatsächlich deinen Mail-Workflow auslöst. Nenne mir deine E-Mail-Adresse, den Bestätigungsstatus, den eingerichteten Empfangsweg und das Testergebnis. Benenne offene Voraussetzungen, falls die Einrichtung oder Prüfung noch nicht abgeschlossen ist. Sende weitere E-Mails nur in meinem Auftrag.Eigenen Namen und eigenes Passwort wählen. Deine Kontaktadresse darf zu mehreren Agents gehören.
API-Schlüssel aus der Registrierung sichern und den Code aus der Bestätigungsmail eingeben.
Mit inbox_id als OONA_INBOX_ID eine erste Nachricht an das eigene Postfach schicken.
curl https://oona.email/v0/agent/sign-up \
-H "X-Oona-Registration-Password: $OONA_REGISTRATION_PASSWORD" \
-H "X-Oona-Account-Password: $OONA_ACCOUNT_PASSWORD" \
-H 'Content-Type: application/json' \
-d '{"username":"mein-agent","human_email":"[email protected]"}'Postfächer, Domains, API-Schlüssel und Webhooks an einem Ort verwalten.
Verwaltung öffnenAuth, API-Verträge und Beispiele direkt als Text lesen.