# twilio-sendgrid-email-send

Скилл учит агента отправлять письма через SendGrid v3 Mail Send API: одиночные, пакетные с шаблонами, отложенные и с вложениями. Нужен ключ SendGrid с префиксом SG.

- скилл · `type=skill` · Codex, ChatGPT · ★ 7596
- Автор: Twilio · официальный репозиторий OpenAI
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/openai/plugins/tree/HEAD/plugins/twilio-developer-kit/skills/twilio-sendgrid-email-send/SKILL.md
- Обновлён: 2026-10-08
- HTML: https://affpapa.org/nevibecode/skills/twilio-sendgrid-email-send

## Что делает

Скилл описывает работу с эндпоинтом `POST /v3/mail/send` и даёт готовые примеры на Python и Node.js. Одиночная отправка, пакетная рассылка с динамическими шаблонами Handlebars (ID начинаются с `d-`), отложенная отправка, вложения в base64, категории и custom args для аналитики. Отдельный раздел — sandbox mode: запрос проверяется, но письмо не уходит, ответ приходит `200 OK` вместо `202 Accepted`.

Устроено как справочник с кодом и списком жёстких ограничений. Отложить отправку можно не больше чем на 72 часа, а отменить — только если batch ID присвоен заранее. `send_at` принимает Unix-секунды: `Date.now()` в JavaScript отдаёт миллисекунды, и такой timestamp молча отклоняется. Больше 1000 получателей за один вызов отправить нельзя, вложения — до 30MB.

Перед отправкой агент обязан согласовать получателей, тему и текст с пользователем: письмо после доставки не отозвать. Скилл не подойдёт, если вы работаете с Twilio Email API на `comms.twilio.com` — это другой продукт с другими учётными данными. Типичные грабли: опечатка в ключе `dynamic_template_data` не даёт ошибки, переменная просто отрендерится пустой строкой. Это повод проверять шаблоны на тестовой отправке.

## Установка

### Codex (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add openai/plugins --skill twilio-sendgrid-email-send -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/twilio-sendgrid-email-send/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Claude Code

1. **Через Skills CLI (Vercel)**
```bash
npx skills add openai/plugins --skill twilio-sendgrid-email-send -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/twilio-sendgrid-email-send/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/twilio-sendgrid-email-send/

### Cursor

**Вручную: положить файлы**
- Файл: `.cursor/skills/twilio-sendgrid-email-send/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install openai/plugins twilio-sendgrid-email-send
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/twilio-sendgrid-email-send/SKILL.md`

### Gemini CLI

**Командой платформы**
```bash
gemini skills install https://github.com/openai/plugins --path plugins/twilio-developer-kit/skills/twilio-sendgrid-email-send
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/twilio-sendgrid-email-send/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/openai/plugins/tree/HEAD/plugins/twilio-developer-kit/skills/twilio-sendgrid-email-send/SKILL.md

## Когда брать
- отправить письмо с подтверждением заказа из бэкенда
- разослать персонализированные письма по списку получателей
- отложить отправку письма на несколько часов и отменить её
- приложить PDF-счёт к письму
- проверить запрос на отправку без реальной доставки

## Примеры запросов агенту
- Отправь письмо с подтверждением заказа на alice@example.com через SendGrid
- Сделай пакетную рассылку по динамическому шаблону d-xxxxxxxxxxxxxxxxxxxxxxxxxxxx для двух получателей
- Запланируй отправку на час вперёд и покажи batch_id, чтобы я мог её отменить

## Похожие
- [email-smtp-send](https://affpapa.org/nevibecode/skills/email-smtp-send.md) — скилл · 6800 установок
- [send-email](https://affpapa.org/nevibecode/skills/send-email.md) — скилл · 652 установки
- [connector-twilio](https://affpapa.org/nevibecode/skills/connector-twilio.md) — скилл · 11200 установок
- [Twilio SMS Automation](https://affpapa.org/nevibecode/skills/twilio-sms-automation.md) — скилл · 5400 установок
- [email-template-builder](https://affpapa.org/nevibecode/skills/email-template-builder.md) — скилл · 602 установки
- [twilio-communications](https://affpapa.org/nevibecode/skills/sickn33-twilio-communications.md) — скилл · 994 установки

Из того же набора: [openai/plugins](https://affpapa.org/nevibecode/by/openai/plugins.md) — 304 карточки

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md