Эндпоинт пакетной отправки принимает много сообщений одним запросом API и возвращает отдельный результат для каждого получателя, поэтому ошибка в одной строке не отменяет весь пакет.
Отправлять кампанию десятью тысячами одиночных запросов медленно, к тому же задолго до окончания вы упрётесь в лимит запросов. Пакетный эндпоинт принимает много сообщений за один вызов: вверху задаются общие значения по умолчанию — например, отправитель, метка кампании, расписание и темп, — а ниже идут сами сообщения, каждое со своим получателем, текстом и возможными переопределениями.
Проверка проходит на двух уровнях. Некорректный запрос — повреждённый JSON или отсутствующий список — отклоняется целиком, и в очередь ничего не ставится. Корректный запрос оценивается по каждому сообщению: допустимые сообщения принимаются и ставятся в очередь, а недопустимые — с неподдерживаемым префиксом или номером не в формате E.164 — возвращаются в том же списке отклонёнными, с указанием ошибки. Поэтому успешный статус запроса означает, что пакет обработан, а не что приняты все сообщения, и ответ нужно разбирать поэлементно. Если передать с пакетом ключ идемпотентности, повтор после тайм-аута не поставит пакет в очередь дважды.
Пример
Условная клиника отправляет три напоминания одним пакетом. Два номера корректны, а у третьего префикс, который не обслуживает ни один маршрут. В ответе — два принятых сообщения с идентификаторами и одно отклонённое с ошибкой. Клиника исправляет третий номер и отправляет его отдельно, а не повторяет весь пакет, что продублировало бы первые два.
Типичные ошибки
- Понимать успешный ответ как «всё отправлено», не проверяя результаты по каждому сообщению.
- Повторно отправлять весь пакет после частичного отклонения.
- Помещать срочные коды в один пакет с медленной кампанией, отправляемой в заданном темпе.
В SMSMeteor: POST /v1/messages/batch принимает до 1 000 сообщений за запрос. Заданные на уровне пакета from, campaign, send_at, window и pace (per_minute или over_hours) применяются ко всем сообщениям, в которых они не переопределены. Некорректный запрос отклоняется целиком; недопустимые элементы возвращаются со статусом rejected и описанием ошибки и никогда не оплачиваются, а допустимые ставятся в очередь. Ответ содержит batch_id, accepted, rejected, total_price и messages[], а пакет считается одним запросом в рамках лимита. См. справочник по пакетной отправке и статью о том, как перечисляются отклонения.
