97 lines
2.6 KiB
Markdown
97 lines
2.6 KiB
Markdown
|
|
########################### skills/brevo/SKILL.md
|
|
|
|
---
|
|
name: brevo
|
|
description: Manage Brevo contacts, lists, transactional emails, and campaigns.
|
|
---
|
|
|
|
# Brevo Email Marketing API
|
|
|
|
Use this skill when you need to manage Brevo contacts, lists, transactional emails, and campaigns.
|
|
|
|
## Authentication
|
|
Use this shell pattern:
|
|
`BREVO_KEY=$(cat ~/.config/brevo/api_key)`
|
|
|
|
All Brevo API requests require:
|
|
`api-key: $BREVO_KEY`
|
|
|
|
## Base URL
|
|
`https://api.brevo.com/v3`
|
|
|
|
## Common endpoints
|
|
- Create contact: `POST /contacts`
|
|
- Get contact: `GET /contacts/{email}`
|
|
- Update contact: `PUT /contacts/{email}`
|
|
- List contacts: `GET /contacts?limit=50&offset=0`
|
|
- Get all lists: `GET /contacts/lists`
|
|
- Add contacts to list: `POST /contacts/lists/{listId}/contacts/add`
|
|
- Send transactional email: `POST /smtp/email`
|
|
- Get templates: `GET /smtp/templates`
|
|
|
|
## Best practices
|
|
- Always check blacklisted or unsubscribed contacts before importing.
|
|
- Use `updateEnabled: true` when creating contacts.
|
|
- Prefer templates for transactional emails.
|
|
- Store list IDs in config, not hardcoded prompts.
|
|
|
|
########################### skills/brevo/SKILL.md
|
|
|
|
|
|
##########################/data/state/.config/brevo/api_key
|
|
{
|
|
"skills": {
|
|
"entries": {
|
|
"brevo": {
|
|
"enabled": true,
|
|
"env": {
|
|
"BREVO_KEY": "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"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
##########################/data/state/.config/brevo/api_key
|
|
|
|
export BREVO_KEY="$(cat ~/.config/brevo/api_key)"
|
|
|
|
curl "https://api.brevo.com/v3/account" \
|
|
-H "api-key: $BREVO_KEY"
|
|
|
|
curl "https://api.brevo.com/v3/contacts/lists?limit=50" \
|
|
-H "api-key: $BREVO_KEY"
|
|
|
|
################################### config
|
|
📧 Brevo Email Configuration
|
|
|
|
SMTP Relay
|
|
|
|
• Server: smtp-relay.brevo.com
|
|
• Port: 587
|
|
• Login: a5d823001@smtp-brevo.com
|
|
• Password: xsmtpsib-dc1bd72ebb127d5b026e510adeaa2261b3044585afaef2fe0c12b7868beaf445-eQi9LSnFiKX6WXyg
|
|
|
|
API (v3)
|
|
|
|
• Base URL: https://api.brevo.com/v3
|
|
• API Key: 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
|
|
|
|
Test Send (Working)
|
|
|
|
• Sender: eujin.lai.82@gmail.com
|
|
• Recipient: lejin2000@hotmail.com
|
|
• Last Message ID: <202603300718.31101727365@smtp-relay.mailin.fr>
|
|
• Status: ✅ Verified
|
|
|
|
Reusable Scripts
|
|
|
|
• send_brevo_api.py: Basic test
|
|
• send_test_email_custom.py: Custom to/from
|
|
|
|
Notes
|
|
|
|
• Stored in /data/state/.config/brevo/api_key for secure access
|
|
• Local backup: /data/workspace/MEMORY.md and /data/workspace/brevo_notes.md
|
|
|
|
######################################## |