B

布雷沃

(Brevo)

brevo

🌐 English

Brevo（以前称为 Sendinblue）电子邮件营销 API，用于管理联系人、列表、发送交易电子邮件和营销活动。在导入联系人、发送电子邮件、管理订阅或使用电子邮件自动化时使用。

数据来源：ClawHub。在 ClawSkills 查看

2.4k下载量

3收藏数

1浏览量

安装

选择你使用的 Agent

方法一：命令行安装（推荐）

关于布雷沃

--- name: brevo version: 1.0.0 description: Brevo (formerly Sendinblue) email marketing API for managing contacts, lists, sending transactional emails, and campaigns. Use when importing contacts, sending emails, managing subscriptions, or working with email automation. ---

Brevo Email Marketing API

Manage contacts, send emails, and automate marketing via Brevo's REST API.

Authentication

BREVO_KEY=$(cat ~/.config/brevo/api_key)

All requests require header: api-key: $BREVO_KEY

Base URL

https://api.brevo.com/v3

Common Endpoints

Contacts

| Action | Method | Endpoint | |--------|--------|----------| | Create contact | POST | /contacts | | Get contact | GET | /contacts/{email} | | Update contact | PUT | /contacts/{email} | | Delete contact | DELETE | /contacts/{email} | | List contacts | GET | /contacts?limit=50&offset=0 | | Get blacklisted | GET | /contacts?emailBlacklisted=true |

Lists

| Action | Method | Endpoint | |--------|--------|----------| | Get all lists | GET | /contacts/lists | | Create list | POST | /contacts/lists | | Get list contacts | GET | /contacts/lists/{listId}/contacts | | Add to list | POST | /contacts/lists/{listId}/contacts/add | | Remove from list | POST | /contacts/lists/{listId}/contacts/remove |

Emails

| Action | Method | Endpoint | |--------|--------|----------| | Send transactional | POST | /smtp/email | | Send campaign | POST | /emailCampaigns | | Get templates | GET | /smtp/templates |

Examples

Create/Update Contact

curl -X POST "https://api.brevo.com/v3/contacts" \
  -H "api-key: $BREVO_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "[email protected]",
    "listIds": [10],
    "updateEnabled": true,
    "attributes": {
      "NOMBRE": "John",
      "APELLIDOS": "Doe"
    }
  }'

Get Contact Info

curl "https://api.brevo.com/v3/contacts/[email protected]" \
  -H "api-key: $BREVO_KEY"

Update Contact Attributes

curl -X PUT "https://api.brevo.com/v3/contacts/[email protected]" \
  -H "api-key: $BREVO_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "listIds": [10, 15],
    "attributes": {
      "CUSTOM_FIELD": "value"
    }
  }'

Send Transactional Email

curl -X POST "https://api.brevo.com/v3/smtp/email" \
  -H "api-key: $BREVO_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "sender": {"name": "My App", "email": "[email protected]"},
    "to": [{"email": "[email protected]", "name": "John"}],
    "subject": "Welcome!",
    "htmlContent": "<p>Hello {{params.name}}</p>",
    "params": {"name": "John"}
  }'

Send with Template

curl -X POST "https://api.brevo.com/v3/smtp/email" \
  -H "api-key: $BREVO_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": [{"email": "[email protected]"}],
    "templateId": 34,
    "params": {
      "NOMBRE": "John",
      "FECHA": "2026-02-01"
    }
  }'

List All Contact Lists

curl "https://api.brevo.com/v3/contacts/lists?limit=50" \
  -H "api-key: $BREVO_KEY"

Add Contacts to List (Bulk)

curl -X POST "https://api.brevo.com/v3/contacts/lists/10/contacts/add" \
  -H "api-key: $BREVO_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "emails": ["[email protected]", "[email protected]"]
  }'

Safe Import Pattern

When importing contacts, always respect unsubscribes:

import requests

BREVO_KEY = "your-api-key"
HEADERS = {'api-key': BREVO_KEY, 'Content-Type': 'application/json'}
BASE = 'https://api.brevo.com/v3'

def get_blacklisted():
    """Get all unsubscribed/blacklisted emails"""
    blacklisted = set()
    offset = 0
    while True:
        r = requests.get(
            f'{BASE}/contacts?limit=100&offset={offset}&emailBlacklisted=true',
            headers=HEADERS
        )
        contacts = r.json().get('contacts', [])
        if not contacts:
            break
        for c in contacts:
            blacklisted.add(c['email'].lower())
        offset += 100
    return blacklisted

def safe_import(emails, list_id):
    """Import contacts respecting unsubscribes"""
    blacklisted = get_blacklisted()
    
    for email in emails:
        if email.lower() in blacklisted:
            print(f"Skipped (unsubscribed): {email}")
            continue
        
        r = requests.post(f'{BASE}/contacts', headers=HEADERS, json={
            'email': email,
            'listIds': [list_id],
            'updateEnabled': True
        })
        
        if r.status_code in [200, 201, 204]:
            print(f"Imported: {email}")
        else:
            print(f"Error: {email} - {r.text[:50]}")

Contact Attributes

Brevo uses custom attributes for contact data:

{
  "attributes": {
    "NOMBRE": "John",
    "APELLIDOS": "Doe",
    "FECHA_ALTA": "2026-01-15",
    "PLAN": "premium",
    "CUSTOM_FIELD": "any value"
  }
}

Create attributes in Brevo dashboard: Contacts → Settings → Contact attributes.

Response Codes

| Code | Meaning | |------|---------| | 200 | Success (GET) | | 201 | Created (POST) | | 204 | Success, no content (PUT/DELETE) | | 400 | Bad request (check payload) | | 401 | Invalid API key | | 404 | Contact/resource not found |

Best Practices

Always check blacklist before importing contacts
Use updateEnabled: true to update existing contacts instead of failing
Use templates for consistent transactional emails
Batch operations when adding many contacts to lists
Store list IDs in config, not hardcoded
Log imports for audit trail

Automations

Brevo automations trigger on:

Contact added to list
Contact attribute updated
Email opened/clicked
Custom events via API

Trigger automation manually:

curl -X POST "https://api.brevo.com/v3/contacts/import" \
  -H "api-key: $BREVO_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "listIds": [10],
    "emailBlacklist": false,
    "updateExistingContacts": true,
    "emptyContactsAttributes": false,
    "jsonBody": [
      {"email": "[email protected]", "attributes": {"NOMBRE": "John"}}
    ]
  }'

Useful Queries

# Count contacts in list
curl "https://api.brevo.com/v3/contacts/lists/10" -H "api-key: $BREVO_KEY" | jq '.totalSubscribers'

# Get recent contacts
curl "https://api.brevo.com/v3/contacts?limit=10&sort=desc" -H "api-key: $BREVO_KEY"

# Check if email exists
curl "https://api.brevo.com/v3/contacts/[email protected]" -H "api-key: $BREVO_KEY"

# Get account info
curl "https://api.brevo.com/v3/account" -H "api-key: $BREVO_KEY"

Prompt 示例

安装布雷沃后，可以对 AI 说这些话来触发它

U

Send a Slack message to the #engineering channel about the deployment

A

Formats and sends the message with relevant context, tagging the right people

U

Summarize all unread messages in my inbox from today

A

Reads messages across connected channels and returns a prioritized summary

U

Draft a reply to this customer complaint and send it for review

A

Writes an empathetic, professional response and routes it to the approval queue

常见问题

如何安装布雷沃？▾

将技能文件夹放到 ~/.claude/skills/brevo/ 目录（个人级，所有项目可用），或 .claude/skills/brevo/（项目级）。重启 AI 客户端后，用 /brevo 主动调用，或让 AI 根据上下文自动发现并使用。

布雷沃支持哪些 AI 平台？▾

布雷沃支持 Claude、Cursor、OpenClaw，可与这些 AI 平台无缝集成，扩展其能力。

布雷沃是免费的吗？▾

布雷沃可免费安装使用。请查阅仓库了解许可证信息。

布雷沃有什么功能？▾

Brevo（以前称为 Sendinblue）电子邮件营销 API，用于管理联系人、列表、发送交易电子邮件和营销活动。在导入联系人、发送电子邮件、管理订阅或使用电子邮件自动化时使用。

布雷沃属于哪个分类？▾

布雷沃属于「Communication」分类，该分类的技能帮助 AI 智能体在此领域执行专业任务。

使用场景

Getting Started with Brevo→Automate Communication Workflows with Brevo→Team Collaboration with Brevo→

布雷沃

安装

关于布雷沃

Brevo Email Marketing API

Authentication

Base URL

Common Endpoints

Contacts

Lists

Emails

Examples

Create/Update Contact

Get Contact Info

Update Contact Attributes

Send Transactional Email

Send with Template

List All Contact Lists

Add Contacts to List (Bulk)

Safe Import Pattern

Contact Attributes

Response Codes

Best Practices

Automations

Useful Queries

Prompt 示例

常见问题

使用场景

同类技能推荐

歌革

PollyReach

Agent Phone Call

Slack

布雷沃

安装

关于 布雷沃

Brevo Email Marketing API

Authentication

Base URL

Common Endpoints

Contacts

Lists

Emails

Examples

Create/Update Contact

Get Contact Info

Update Contact Attributes

Send Transactional Email

Send with Template

List All Contact Lists

Add Contacts to List (Bulk)

Safe Import Pattern

Contact Attributes

Response Codes

Best Practices

Automations

Useful Queries

Prompt 示例

常见问题

使用场景

同类技能推荐

歌革

PollyReach

Agent Phone Call

Slack

关于布雷沃