Международные тарифы аутентификации | Документация для разработчиков

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

Например, если ваша компания находится в Индонезии, и вы отправляете шаблон сообщения для аутентификации пользователю WhatsApp с телефонным кодом +62 (Индонезия), и сообщение доставлено, с вас не будет взиматься плата по тарифу международной аутентификации, поскольку вы находитесь в той же стране, что и пользователь. Однако, если ваша компания находится в Индии, с вас будет взиматься плата по тарифу международной аутентификации, если вы соответствуете всем вышеперечисленным критериям.

Дополнительные примеры сценариев см. разделе «Примеры»

Веб-хуки, содержащие информацию о статусе сообщений аналитику ценообразования, будут указывать, было ли оплачено сообщение или набор сообщений по международному тарифу аутентификации.

Если ваша компания отправляет более 750 000 сообщений вне установленных сроков обслуживания клиентов в течение 30-дневного периода, используя все свои бизнес-аккаунты WhatsApp, с уникальными пользователями WhatsApp, чьи телефонные коды соответствуют странам с тарифами, предусматривающими аутентификацию по международным тарифам, то она будет считаться имеющей право на использование тарифов, предусматривающих аутентификацию по международным тарифам.

После подтверждения соответствия требованиям, мы установим время начала действия подписки за 30 дней для каждой страны, в которой действует международный тариф аутентификации. Кроме того, мы попытаемся определить ваше основное местонахождение, используя общедоступную информацию.

Затем мы отправим вам электронное письмо с подтверждением соответствия требованиям , в котором будут указаны указанные вами часы начала и страна, которую мы определили в качестве вашего основного места ведения бизнеса (если нам удалось определить эту страну). Это даст вам 30 дней на подготовку к применению международных тарифов на аутентификацию. веб-хуки , содержащие ваши часы начала и ваше основное место ведения бизнеса (если мы его определили).

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

В следующих странах действуют международные тарифы на аутентификацию:

Подробную информацию о тарифах см. в прайс-листах

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

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

Время начала указано в электронном письме с подтверждением участия и в веб-хуках . Вы также можете получить это время, запросив auth_international_rate_eligibility в любом из бизнес-аккаунтов WhatsApp вашей компании:

Заполнитель	Описание	Пример значения
<ACCESS_TOKEN> Нить	Необходимый. Системный токен или бизнес-токен .	EAAAN6tcBzAUBOZC82CW7iR2LiaZBwUHS4Y7FDtQxRUPy1PHZClDGZBZCgWdrTisgMjpFKiZAi1FBBQNO2IqZBAzdZAA16lmUs0XgRcCf6z1LLxQCgLXDEpg80d41UZBt1FKJZCqJFcTYXJvSMeHLvOdZwFyZBrV9ZPHZASSqxDZBUZASyFdzjiy2A1sippEsF4DVV5W2IlkOSr2LrMLuYoNMYBy8xQczzOKDOMccqHEZD
<API_VERSION> Нить	Необязательный. Версия Graph API.	v25.0
Нить	Необходимый. Идентификатор бизнес-аккаунта WhatsApp.	102290129340398

Заполнитель	Описание	Пример значения
<WABA_ID>	Идентификатор бизнес-аккаунта WhatsApp (WABA).	102290129340398
<START_TIME>	Временная метка Unix, указывающая время начала для всех стран с международной аутентификацией, для которых у вас нет исключения .	1732057507
<EXCEPTION_COUNTRY>	Уникальный объект, описывающий страну, для которой установлено нестандартное время начала. См. страна с нестандартным . Для большинства бизнес-аккаунтов WhatsApp exception_countries будет пустым.

Основное местонахождение вашей компании — это страна, в которой она зарегистрирована. Начиная с 1 мая 2024 года, эта информация будет отображаться в «Основное местонахождение компании» », если мы сможем определить его местоположение, используя общедоступные данные.

Следующая общедоступная информация используется для определения местонахождения вашей компании:

Мы попытаемся определить местонахождение вашей компании в следующих случаях:

Этот процесс может занять до 3 рабочих дней. Результатом этого определения может быть:

Вы будете уведомлены о результате в первом электронном письме, подтверждающем ваше право на участие , или в отдельном электронном письме, если вы использовали Business Manager для редактирования своего местоположения.

Если ваше заявление будет отклонено, если нам потребуется дополнительная информация или если вы не согласны с выбранной нами страной в качестве основного места ведения бизнеса, вы можете изменить местоположение с помощью Менеджера бизнеса.

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

Чтобы установить или изменить основное местоположение вашей компании:

В «Основное местоположение предприятия» в Business Manager также будет отображаться статус:

Вы можете использовать API, чтобы проверить, указано ли основное местоположение вашей компании, запросив primary_business_location в своем аккаунте WhatsApp Business (WABA):

В случае успеха:

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

В электронном письме будет содержаться:

Международные тарифы аутентификации для соответствующих стран начнут действовать с той же даты, если иное не указано в электронном письме с подтверждением соответствия требованиям, в exception_countries в веб-хуках подтверждения соответствия требованиям или exception_countries , возвращаемом при запросе auth_international_rate_eligibility в вашем аккаунте WhatsApp Business (WABA).

С вас всегда будет взиматься плата по внутреннему тарифу для вашего основного места ведения бизнеса, даже если оно указано в exception_countries .

В следующих примерах предположим следующий сценарий:

Запрос auth_international_rate_eligibility в транзакции WABA 12345 возвращает:

Страна C не представлена ​​в ответе, поскольку в ней отсутствует международный тариф на аутентификацию.

Основной местонахождение компании — страна C.

Основной местонахождение компании — страна B.

Для страны B не применяется тариф на международную аутентификацию, поскольку основное местонахождение деятельности компании также находится в стране B.

Веб account_update будет запущен, если ваша компания будет признана имеющей право на международные тарифы. Веб-хук будет включать время начала действия тарифа для каждой страны, в которой действует международный тариф аутентификации.

Список стран, для которых действуют международные тарифы на аутентификацию, см. в прайс

Подпишитесь на account_update, основное местоположение вашей компании . Если мы сможем определить страну, в которой находится ваша компания, мы установим ваше местоположение в этой стране и запустим account_update с двухсимвольным кодом страны, присвоенным свойству BUSINESS_PRIMARY_LOCATION_COUNTRY_UPDATE .

Если за сообщение шаблона аутентификации взимается плата по тарифу authentication-international, то в сообщений о состоянии объект ценообразования будет иметь категорию authentication_international .

Компания,  основной офис которой находится в Индонезии, отправляет пользователю WhatsApp сообщение с шаблоном аутентификации:

Местоположение пользователя	Подходит ли бизнес для участия?	Время начала/после начала работы?	Тариф выставлен
Индонезия	-	-	Аутентификация
Индия	Нет	-	Аутентификация
Индия	Да	Нет	Аутентификация
Индия	Да	Да	Международная аутентификация

Компания, основной офис которой находится в Индии, отправляет пользователю WhatsApp сообщение с шаблоном аутентификации:

Местоположение пользователя	Подходит ли бизнес для участия?	Время начала/после начала работы?	Тариф выставлен
Индия	-	-	Аутентификация
Индонезия	Нет	-	Аутентификация
Индонезия	Да	Нет	Аутентификация
Индонезия	Да	Да	Международная аутентификация

Компания, основной офис которой не имеет тарифа на международную аутентификацию, отправляет пользователю WhatsApp шаблон сообщения для аутентификации:

Местоположение пользователя	Подходит ли бизнес для участия?	Время начала/после начала работы?	Тариф выставлен
Индонезия	Нет	-	Аутентификация
Индонезия	Да	Нет	Аутентификация
Индонезия	Да	Да	Международная аутентификация
Индия	Нет	-	Аутентификация
Индия	Да	Нет	Аутентификация
Индия	Да	Да	Международная аутентификация