Инструменты разработки должны давать разработчикам возможности.
У вас должен быть предсказуемый и доступный контроль с любой предпочитаемой вами платформы: дашборд, MCP, CLI или API. И люди, и агенты должны иметь равный доступ, где оператором выступает разработчик.
Наш путь
Ранее этим летом мы выделили несколько сценариев взаимодействия, которые требовали использования Resend Dashboard, и начали постепенно сокращать разрыв для каждого из них.
Сегодня я рад поделиться тем, как далеко мы продвинулись. Большая часть того, чем вы управляете в дашборде, теперь доступна через MCP, CLI или API. Это направление, которому мы следуем, и именно это мы подразумеваем под headless:
Всё, что умеет дашборд, должно быть доступно и программно.
Всё, что умеет дашборд, должно быть доступно и программно.
Эта инициатива позволяет вам:
- встраивать полную аналитику электронной почты в ваше приложение
- создавать кастомные интерфейсы рассылок для ваших клиентов
- управлять аккаунтом Resend с помощью вашего агента
- создавать персональные дашборды и отчеты
Мы сделаем дашборд лучшим в своем классе и в то же время обеспечим полную работу в режиме headless для каждого нового объекта. Используйте дашборд, когда это целесообразно. Создавайте собственные интерфейсы, когда это не так.
Что вы можете использовать уже сейчас
Хотя многие члены команды внесли свой вклад в достижение этого результата, трех человек стоит отметить особо: Диэль Дуарте (Diel Duarte), Габриэль Миранда (Gabriel Miranda) и Фелипе Фрейтаг (Felipe Freitag).
Вот ключевые изменения, которые мы выпустили за последние несколько месяцев.
- API метрик писем
- Headless API вебхуков
- API отмены рассылок
- API шаринга писем
- API дублирования автоматизации
- API обновления сегментов
- API списка нажатых ссылок
- Обновление названия API-ключа
- API дублирования рассылок
1. API метрик писем
API метрик писем возвращает данные о доставке и вовлеченности для ваших писем — от объема отправки до показателей отписок, сгруппированные или отфильтрованные по периоду, домену, рассылке или письму. Он обеспечивает работу:
- пользовательских дашбордов, отображающих показатели доставки и репутации
- отчетов, суммирующих эффективность кампаний
- оповещений, срабатывающих при резком росте показателей отказов или жалоб
Запрос без параметров возвращает все метрики за последние 7 дней.
Узнайте больше об API метрик писем или прочитайте журнал изменений.
2. Headless API вебхуков
Всё, что доступно на странице сведений о вебхуке, теперь доступно в API, любом SDK, сервере MCP и CLI:
- Список событий: каждое событие, доставленное на вебхук, с указанием статуса доставки
- Получение события: точный полезный нагрузочный блок (payload), который мы отправили на ваш эндпоинт
- Список попыток: каждая попытка с кодом состояния и телом ответа, возвращенными вашим эндпоинтом
- Повторное воспроизведение события: постановка в очередь повторной доставки события вебхука
- Ротация секретного ключа подписи: получение нового секрета без открытия дашборда
В совокупности это позволяет получать список неудачных событий и воспроизводить их в цикле, вызывать команду при сбоях доставки, выполнять ротацию секретов из CI или подключить сервер MCP и спросить вашего агента, что пошло не так.
Начните со списка событий, доставленных на вебхук. Каждое из них имеет статус доставки: success (успешно), failed (ошибка), attempting (попытка) или pending (в ожидании).
Узнайте больше о Headless API вебхуков или прочитайте журнал изменений.
3. API отмены рассылок
API отмены рассылок позволяет отменять рассылку программно. Вы можете использовать его, чтобы остановить рассылку, пока она еще запланирована, или во время отправки до ее завершения.
Чтобы отменить рассылку, используйте ID рассылки вместе с эндпоинтом отмены.
Узнайте больше об API отмены рассылок или прочитайте журнал изменений.
API шаринга писем возвращает ссылку на просмотр любого отправленного или полученного письма в режиме «только чтение», доступную для всех, у кого есть эта ссылка.
- прикреплять живой превью письма к тикету поддержки
- позволять пользователям открывать ссылку «просмотреть это письмо» из вашего приложения
- просить вашего агента выводить письмо при составлении отчета об отправке
Используйте ID любого отправленного или полученного письма. API возвращает полный URL для шаринга, а ссылки истекают по истечении заданного вами времени. Передайте любую длительность до 48 часов, например 10m, 2 hours или 1 day. Значение по умолчанию — 48 часов.
Узнайте больше об API шаринга писем или прочитайте журнал изменений.
5. API дублирования автоматизации
Новый эндпоинт дублирования автоматизации создает копию существующей автоматизации с именем исходной и суффиксом (Copy). Копия создается как отключенный черновик, поэтому ничего не запустится, пока вы ее не проверите и не опубликуете.
Чтобы дублировать автоматизацию, используйте ID автоматизации вместе с эндпоинтом дублирования.
Узнайте больше об API дублирования автоматизации или прочитайте журнал изменений.
6. API обновления сегментов
Вы уже могли создавать, получать, перечислять и удалять сегменты через API. Новый эндпоинт обновления дополняет набор, позволяя переименовывать сегмент из API, CLI или любого официального SDK.
Узнайте больше об API обновления сегментов или прочитайте журнал изменений.
7. API списка нажатых ссылок
API списка нажатых ссылок возвращает каждую ссылку, по которой кликнули в рассылке, с общим количеством и числом уникальных кликов, отсортированную по общему количеству кликов. Используйте его для наполнения собственных дашбордов, сравнения призывов к действию (CTA) в разных кампаниях или выявления самых эффективных ссылок для планирования будущих писем. Для вашего домена должно быть включено отслеживание кликов.
Узнайте больше об API списка нажатых ссылок или прочитайте журнал изменений.
8. Обновление названия API-ключа
Эндпоинт обновления API-ключа переименовывает ключ на месте. Сам токен остается прежним, как и разрешения с ограничением по домену, поэтому вы можете синхронизировать имена ключей с переименованным проектом или упорядочить соглашения об именовании с помощью скрипта без ротации секретов.
Узнайте больше об эндпоинте обновления названия API-ключа или прочитайте журнал изменений.
9. API дублирования рассылок
Большинство новых рассылок создаются на основе уже отправленных. Новый эндпоинт дублирования рассылок создает копию любой рассылки, включая те, которые уже были отправлены. Копия сохраняет сегмент, тему, отправителя, сабжект, адрес для ответа, текст превью и контент, а также начинается как черновик, поэтому ничто не уйдет в рассылку, пока вы не проверите и не отправите ее.
Чтобы дублировать рассылку, используйте ID рассылки вместе с эндпоинтом дублирования.
Узнайте больше об API дублирования рассылок или прочитайте журнал изменений.
Заключение
Теперь, когда мы обеспечили совместимость между всеми различными сервисами, наша следующая цель — предоставить вам более точный контроль.
Всё — от предоставления API-ключей до фильтрации и настройки областей видимости вебхуков — мы делаем для того, чтобы Resend стал лучшим инструментом для разработчиков и агентов.
А пока вы можете начать создание уже сегодня:
- Подключите сервер MCP и управляйте своим аккаунтом Resend с помощью агента
- Установите CLI и выполняйте любые команды из терминала