Email API от Telnyx теперь упрощает тестирование почтовых воркфлоу, получение сообщений и отслеживание того, что происходит на всех этапах жизненного цикла доставки. Новые результаты в песочнице, фильтрация сообщений, названия событий и расширенное покрытие вебхуками предоставляют разработчикам больше возможностей контроля без влияния на продакшн-рассылки.
Что нового
- Детерминированные результаты в песочнице: установите sandbox_mode в значение true, а затем используйте зарезервированного получателя с доменом @test.telnyx.com, чтобы симулировать успешную доставку, жесткий отскок (hard-bounce), мягкий отскок (soft-bounce), жалобу (complaint), попадание в черный список (suppressed), недействительного получателя, сбой DKIM или ограничение частоты запросов (rate-limit). Сценарий с мягким отскоком фиксирует конечный результат отскока с синтетическим ответом 450; письмо при этом не отправляется.
Точные зарезервированные адреса получателей:
- [email protected]
- [email protected]
- [email protected]
- [email protected]
- [email protected]
- [email protected]
- [email protected]
- [email protected]
- Отсутствие влияния на доставку, биллинг и репутацию: сообщения в песочнице не попадают в исходящий канал доставки, не тарифицируются и исключаются из производственной статистики и расчетов репутации отправителя. Симулированные жесткие отскоки и жалобы все же могут создавать блокировки для зарезервированных тестовых адресов.
- Более удобное получение сообщений: ответы сообщений теперь включают теги и метаданные. Запросы списка сообщений могут осуществляться с использованием фильтров filter[tags] и filter[metadata].
- Более точное покрытие событий: опрос событий теперь включает дополнительное каноническое поле canonical_event_type, позволяющее отличать отклонение шлюза как email.gw_reject, тайм-аут отправки как email.injection_timeout и истечение срока действия очереди как email.expired без нарушения работы существующих интеграций.
- Больше событий вебхуков: события отмены, дневного лимита и системного сбоя теперь могут доставляться через настроенные вебхуки.
Почему это важно
Разработчики могут тестировать как успешные сценарии, так и сценарии сбоев без генерации реального почтового трафика, что упрощает проверку поведения приложения перед выходом в продакшн.
Теги и метаданные также делают извлечение сообщений более полезным, в то время как расширенное покрытие событий предоставляет более четкие сигналы о том, почему электронное письмо было отклонено, задержано, просрочено или не отправлено по другим причинам.
Дополнительное покрытие вебхуками означает, что приложения могут реагировать на большее число событий жизненного цикла Email API по мере их возникновения.
Начало работы
Предварительные требования
- Аккаунт Telnyx
- API-ключ Telnyx
- Для вебхуков — настроенный HTTPS-эндпоинт вебхука
Установите sandbox_mode в значение true в запросе на отправку и выберите одного из зарезервированных получателей @test.telnyx.com, указанных выше. Для мониторинга вебхуков подпишитесь на email.cancelled, email.daily_limit_exceeded и/или существующее событие email.failed по мере необходимости.
Используйте зарезервированных получателей @test.telnyx.com для запуска детерминированных тестовых результатов. Для мониторинга продакшна настройте вебхуки Email API для событий, которые вашему приложению необходимо получать.
Узнайте больше в документации по вебхукам и событиям Email, а также в документации по отправке Email.
