Что остаётся одинаковым
У аккаунта один баланс, одна таблица тарифов и общие отчёты. Сообщение стоит одинаково независимо от отправки через редактор или код, отображается в том же списке и вызывает те же вебхуки. Выбор влияет на рабочий процесс, но не на цену или качество.
Когда удобнее панель
Рассылка состоит из файла, текста и времени. Редактор импортирует файл, показывает стоимость по странам и самый длинный итоговый вариант, позволяет планировать по местному времени и отслеживать доставку в реальном времени. Этого обычно достаточно командам маркетинга и поддержки, которые запускают несколько рассылок в неделю.
Когда нужен API
Коды, уведомления, квитанции и любые сообщения, вызванные событием в вашей системе, следует отправлять через API. На каждое сообщение приходится один запрос, Idempotency-Key делает повторы безопасными, а вебхук сообщает системе о доставке. Для массовой отправки из собственного конвейера данных используйте пакетный метод: до 1000 сообщений за запрос с теми же настройками расписания, что и в редакторе.
Как использовать оба способа
Большинство аккаунтов используют оба способа. Добавляйте к сообщениям API поле campaign, чтобы в отчёте они группировались так же, как рассылки из панели. Создавайте отдельный ключ для каждой системы: отзыв одного ключа не остановит остальные. Настройте вебхук при низком балансе, чтобы автоматическая отправка не помешала кампании маркетинговой команды.
Ключи и доступ
Ключу можно выдать права отправки, чтения или оба права и ограничить его списком разрешённых IP-адресов. Тестовый ключ позволяет настроить интеграцию без расходов. Отдельный тариф или согласование не нужны: аккаунт, который отправляет из панели, может создать ключ и через минуту выполнить запрос из кода.
Что-то непонятно или устарело? Напишите на [email protected]. Мы внесём исправления в руководство и обновим дату.