mirror of
https://github.com/myronblair/infra
synced 2026-06-30 17:50:10 -05:00
myron
52f6073593
AI context/memory from Claude Code sessions covering all infrastructure: JARVIS, NovaCPX, DO sites, Proxmox, FusionPBX, MediaStack, and project feedback/preferences.
66 lines
3.1 KiB
Markdown
66 lines
3.1 KiB
Markdown
---
|
|
name: project-tomsjavajive-email
|
|
description: "Tom's Java Jive email service — CyberMail (CyberPersons), API key stored in config.php"
|
|
metadata:
|
|
node_type: memory
|
|
type: project
|
|
originSessionId: f0b18417-cc26-4fdf-87ec-7b2d69b02c44
|
|
---
|
|
|
|
## Email Service: CyberMail by CyberPersons
|
|
|
|
**API Key:** `sk_live_d52bf062797105aeaafac9954c21ff988e9b41b77315807d`
|
|
**API Key Management:** https://platform.cyberpersons.com/email/api-keys/
|
|
**Webmail / Hosting Management:** https://platform.cyberpersons.com/email/webmail/hosting/
|
|
|
|
**Stored in:** `/home/tomsjavajive.com/public_html/config/config.php`
|
|
- Constant: `CYBERMAIL_API_KEY`
|
|
- Replaced the old `SENDGRID_API_KEY` placeholder
|
|
|
|
## Email Handler
|
|
- File: `/home/tomsjavajive.com/public_html/includes/email.php`
|
|
- Class: `SendGridEmail` (still named SendGrid — rename when integrating CyberMail API)
|
|
- Sends: order confirmation, shipping notification, password reset, welcome, abandoned cart
|
|
- Currently references `CYBERMAIL_API_KEY` constant (was SENDGRID_API_KEY)
|
|
|
|
## CyberMail API Reference
|
|
- **Send:** `POST https://platform.cyberpersons.com/email/v1/send`
|
|
- **Status:** `GET https://platform.cyberpersons.com/email/v1/messages/{message_id}`
|
|
- **Account Stats:** `GET https://platform.cyberpersons.com/email/v1/account/stats`
|
|
- **Auth:** `Authorization: Bearer {api_key}`
|
|
|
|
## Error Codes
|
|
| HTTP | error.type | Description |
|
|
|------|-----------|-------------|
|
|
| 400 | invalid_request | Missing required fields or invalid email format |
|
|
| 403 | domain_not_verified | Sending domain not verified |
|
|
| 403 | domain_not_found | Domain not registered to account |
|
|
| 403 | account_inactive | Account suspended or inactive |
|
|
| 403 | forbidden | API key domain/IP restriction |
|
|
| 404 | not_found | Message ID not found |
|
|
| 429 | rate_limit_exceeded | Rate limit reached (includes retry_after field) |
|
|
| 500 | send_failed | Sending failed after failover |
|
|
| 503 | service_unavailable | No healthy mail nodes |
|
|
|
|
## PHP Integration
|
|
- `email.php` uses `Authorization: Bearer` header, curl over HTTPS (port 443 — no DO block)
|
|
- Success returns `['success'=>true, 'message_id'=>'...']`
|
|
- Failure returns `['success'=>false, 'error'=>'friendly message', 'error_type'=>'code', 'code'=>httpCode]`
|
|
- 429 errors include retry_after seconds in the error message
|
|
- **Required fields:** `from`, `to`, `subject`, `html` (or `text`)
|
|
- **Optional:** `text`, `cc`, `bcc`, `reply_to`, `tags`, `metadata`, `headers`
|
|
- **Success response:** 202 with `data.message_id`, `data.status`
|
|
- **Domain must be verified** at platform.cyberpersons.com before sending
|
|
|
|
## SMTP Credentials (blocked by DigitalOcean — use API instead)
|
|
- Host: mail.cyberpersons.com | Port: 587 | Security: STARTTLS
|
|
- Username: `smtp_49a1fa9c0f15d2d7`
|
|
- Password: `T3mOFSMK1SG1l4D1d7N8NefRd8xypwMy`
|
|
- DO blocks outbound port 587 — API over HTTPS is the working approach
|
|
|
|
## Current Status
|
|
- email.php rewritten to use CyberMail API (curl over HTTPS port 443)
|
|
- `SendGridEmail` class renamed to `Email`, `sendEmail()` helper unchanged
|
|
- Blocked by: `tomsjavajive.com` domain not verified in CyberMail dashboard
|
|
- Fix: verify domain at platform.cyberpersons.com (add DNS TXT/CNAME records)
|