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