ВойтиНачать бесплатный пробный период
Meta Tech Provider

Ошибка 131060: неподдерживаемое сообщение на номере Coexistence

Ошибка 131060 приходит в вебхуке messages как сообщение типа unsupported с заголовком «Это сообщение сейчас недоступно». На номере Coexistence Meta называет её ожидаемой: чаще всего она появляется, когда человек пишет бизнесу впервые, нередко сразу после перехода по объявлению Click-to-WhatsApp, и обычно исчезает за несколько секунд. Само сообщение можно прочитать в приложении WhatsApp Business.

easyCoexistence не пускает неподдерживаемые сообщения в автоматизации, поэтому ваш AI никогда не отвечает на то, что не может прочитать, и по-прежнему передаёт исходную полезную нагрузку Meta вашей системе, если задан Forward URL.

131060

Код Meta для входящего сообщения, которое сейчас недоступно, с заголовком «Это сообщение сейчас недоступно».

Seconds

Meta говорит, что ошибка обычно исчезает в течение нескольких секунд, после чего WhatsApp доставляет сообщения в обычном режиме.

First contact

Основной сценарий, который называет Meta: пользователь WhatsApp пишет бизнесу впервые, что нередко происходит сразу после перехода по объявлению Click-to-WhatsApp.

131051

Другой код в том же вебхуке: Cloud API вообще не поддерживает этот тип сообщения.

Skipped

Автоматизации easyCoexistence не запускаются на сообщении типа unsupported; следующее читаемое сообщение из этого чата запускает их.

Что содержит вебхук 131060?

Это обычный вебхук messages, в котором сообщение имеет поле type со значением unsupported и массив errors. Ошибка содержит код 131060 и заголовок «Это сообщение сейчас недоступно», совпадающий с текстом сообщения об ошибке. Объект unsupported называет тип содержимого, который Meta не смогла передать; список значений Meta включает image, interactive, reaction и poll_creation. Текста и media id нет, поэтому в полезной нагрузке ничего не сообщает о том, что написал клиент. Номер отправителя, id сообщения и временная метка присутствуют, как обычно.

messages webhook with error 131060 (shape from Meta's reference, values illustrative)
{
  "object": "whatsapp_business_account",
  "entry": [{
    "id": "<WABA_ID>",
    "changes": [{
      "field": "messages",
      "value": {
        "messaging_product": "whatsapp",
        "metadata": {
          "display_phone_number": "<BUSINESS_NUMBER>",
          "phone_number_id": "<PHONE_NUMBER_ID>"
        },
        "contacts": [{ "profile": { "name": "Ana" }, "wa_id": "5511999998888" }],
        "messages": [{
          "from": "5511999998888",
          "id": "wamid.HBgN...",
          "timestamp": "1762876800",
          "type": "unsupported",
          "errors": [{
            "code": 131060,
            "title": "This message is currently unavailable.",
            "message": "This message is currently unavailable."
          }],
          "unsupported": { "type": "<UNSUPPORTED_TYPE>" }
        }]
      }
    }]
  }]
}

Почему это происходит на номере Coexistence?

Руководство Meta по Coexistence говорит, что партнёры «могут получать вебхук messages с типом unsupported и кодом ошибки 131060», и что это ожидаемо. Названы два сценария.

Первый: пользователь WhatsApp пишет бизнесу впервые, что, по словам Meta, особенно часто случается, когда человек переходит по объявлению Click-to-WhatsApp и сразу отправляет сообщение. Второй: пользователь WhatsApp на связанном устройстве, которое не поддерживается, отправляет бизнесу сообщение или получает от него.

Механизм Meta не объясняет. Важнее другое: ошибка обычно исчезает за несколько секунд, а затем WhatsApp доставляет сообщения в обычном режиме.

Что должен сделать бизнес, когда такое приходит?

Прочитать сообщение в приложении. Meta советует платформам сообщать бизнесу, что сообщение нужно проверить в приложении WhatsApp Business, потому что у приложения на телефоне оно есть, даже если копия в API была недоступна.

На практике: откройте чат на телефоне, прочитайте, что написал клиент, и ответьте оттуда, либо дождитесь следующего сообщения клиента, которое обычно приходит через API без ошибки. Ответ с телефона также сообщает автоматизациям, что чатом занимается человек. Для рекламной кампании ждите небольшого всплеска таких сообщений в начале новых диалогов: это не сбой.

Как должны реагировать ваш софт и AI?

Относитесь к этому как к известному событию, а не как к сбою. Подтвердите вебхук кодом 200, как для любой доставки, чтобы Meta не отправляла его повторно. Сохраняйте id сообщения и отправителя, чтобы связать его с последующим диалогом. Никогда не передавайте пустое сообщение AI как текст: без содержимого любой ответ будет догадкой. И настраивайте оповещение о частоте событий 131060, а не на отдельные события.

  • Быстро возвращайте 200 и дедуплицируйте по id сообщения, как для любого вебхука.
  • Не отвечайте через AI и не сопоставляйте по ключевым словам тип unsupported.
  • Показывайте команде, что сообщение ждёт в приложении на телефоне.
  • Считайте 131060 отдельно от настоящих сбоев в панелях управления.

Запускаются ли автоматизации на сообщении типа unsupported?

В easyCoexistence нет. Автоматизации читают текстовые сообщения, ответы кнопками и списками, подписи к медиа и заполнители вроде «[голосовое сообщение]». У сообщения типа unsupported ничего из этого нет, поэтому ни одна автоматизация на него не отвечает и запуска не появляется. Если задан Forward URL, ваша система всё равно получит исходную полезную нагрузку Meta, включая ошибку. В прямом режиме Meta отправляет её сразу на ваш сервер.

Следующее читаемое сообщение от этого человека запускает автоматизации как обычно. Так как для этого чата ещё ничего не сохранено, автоматизация «Первое сообщение», например приветственный ответ, ответит именно на следующее сообщение.

Чем 131060 отличается от 131051?

Оба приходят с типом unsupported в одном вебхуке messages, поэтому их путают в логах. Для планирования они означают противоположное: одна ошибка это короткий разрыв, который исправляется сам, а другая это постоянное ограничение API для этого типа содержимого. Различайте их в обработчике по errors[0].code, а не по типу. Таблица сводит то, что справочники Meta говорят о каждом коде.

131060131051
TitleThis message is currently unavailable.Message type unknown
MeaningThe message cannot be passed on right nowThe Cloud API does not support that type
Typical causeFirst contact on a Coexistence number, often after an ad tapContent the API never delivers
How longUsually clears within secondsPermanent for that content
What to doRead it in the WhatsApp Business appAsk the customer for text, or read it in the app

Распространённые ошибки

  • Оповещение на отдельные события 131060. Meta называет их ожидаемыми на номерах Coexistence; следите за частотой.
  • Передача пустого сообщения AI. В полезной нагрузке нет текста, поэтому ответ был бы придуман.
  • Ответ на вебхук кодом ошибки. Meta повторно отправляет вебхуки, которые не прошли, поэтому одно сообщение unsupported превращается в несколько доставок.
  • Предположение, что сообщение потеряно. Оно находится в приложении WhatsApp Business; недоступной была только копия в API.
Настройка с EasyCoexistence

Номер остаётся в приложении на телефоне, где можно прочитать исходное сообщение. От US$ 9 до US$ 0,75 за подключённый номер в месяц, по мере добавления номеров, с бесплатным пробным периодом на 3 дня.

Часто задаваемые вопросы

Можно ли получить исходное содержимое через API?

Рекомендация Meta для 131060 проверить приложение WhatsApp Business. В справочнике вебхуков Meta нет описания способа получить содержимое позже.

Значит ли 131060, что номер сломан?

Нет. Если сообщения от обычных контактов продолжают приходить как 131060 часами, попросите ваш AI выполнить get_number_health или проверить подключение, но всплески при первом контакте ожидаемы.

Бывает ли это у номеров, которые используют только Cloud API?

Meta описывает шаблон первого контакта в руководстве для номеров, подключённых через приложение WhatsApp Business, то есть для Coexistence. Сам код относится к общему справочнику вебхуков Meta, поэтому обрабатывайте его так же на любом номере.

Взимается ли за это плата?

Это входящее сообщение. Meta списывает плату с бизнеса за сообщения, которые он отправляет, поштучно, по категории и стране, в его собственном аккаунте WhatsApp Business Account.

Читайте дальше

Повторы вебхуков WhatsApp, дубликаты и порядок: как с ними работатьMeta повторяет доставку вебхуков WhatsApp до 7 дней, поэтому дубликаты обычны, а порядок не гарантирован. Ключи дедупликации и безопасный обработчик.После подключения номер показывает Pending или OfflineЧто значат Pending и Offline для номера Coexistence в WhatsApp Manager, какие поля Meta проверить после подключения и когда переподключить номер.Вебхук messagesЧто несёт полезная нагрузка, как подтвердить получение и почему поле не попадает к провайдеру на маршрутизированном номере.Ошибка WhatsApp 131051: неподдерживаемый тип сообщенияОшибка 131051 означает, что тип сообщения не поддерживается. На номере Coexistence некоторые типы недоступны.Приветственное сообщение в WhatsApp для новых контактов с шаблоном купонаАвтоматически приветствуйте новых контактов в WhatsApp: триггер первого сообщения, фиксированный текст с их именем или одобренный шаблон купона BEMVINDO10.

Готовы начать?

Настройте WhatsApp Coexistence за несколько минут, а не месяцев. Приложение продолжит работать на телефоне.

Начать бесплатный пробный период

Проверено по состоянию на