Повторы без дубликатов
Как повторить запрос после сбоя сети и не отправить новое сообщение по ошибке.
Правило ключа
POST /messages требует Idempotency-Key в формате UUID. Для одной бизнес-операции сохраняйте один ключ и неизменное тело. Новый ключ используйте для нового сообщения. При повторе с тем же ключом и другим телом возникает конфликт.
Сеть оборвалась
- Не создавайте новую бизнес-операцию только из-за timeout.
- Повторите тот же запрос с прежним Idempotency-Key.
- Сохраните возвращённый Message ID.
- Отслеживайте итоговую доставку по журналу и webhook.
Известная ошибка и неизвестный результат
POST /messages/{id}/retry повторяет подходящую неудачную отправку. Сначала устраните причину. Для outcome_unknown требуется явное тело {"confirm_outcome_unknown": true}: сервер мог успеть передать сообщение Meta, поэтому повтор способен доставить дубликат.
Остался вопрос по этой инструкции?Написать в поддержку →