WhatsApp Cloud API - Регистрация API | Документация для разработчиков
WhatsApp Cloud API - Регистрация API
Экземпляр для программы магистратуры (LLM)
Версия
WhatsApp Cloud API , размещенный на платформе Meta, является официальным API платформы WhatsApp Business, используемым для обмена сообщениями в бизнес-среде. В этой подборке собраны распространенные запросы, примеры ответов и ссылки на вспомогательную документацию, которые помогут вам быстро начать работу с API.
Обзор облачного API
Облачный API позволяет средним и крупным компаниям взаимодействовать с клиентами в масштабах предприятия. Используя API, компании могут создавать системы, которые связывают тысячи клиентов с агентами или ботами, обеспечивая как программную, так и ручную коммуникацию. Кроме того, компании могут интегрировать API с многочисленными внутренними системами, такими как CRM и маркетинговые платформы.
Начало работы с Cloud API
Для использования API и этой коллекции вам необходимо иметь бизнес-портфолио Meta, бизнес-аккаунт WhatsApp и рабочий номер телефона. Если вы выполните шаги, описанные в по началу работы , эти ресурсы будут созданы для вас.
Начните работу в качестве партнера по решениям
В этом руководстве описаны шаги, которые должны предпринять партнеры по решениям, чтобы предложить облачный API своим клиентам.
Переход от локального API к облачному API
В этом руководстве объясняется, как перенести номера телефонов компаний из локального API в облачный API.
Среда
Для этой коллекции существует соответствующая среда , которую необходимо выбрать при использовании коллекции. Если вы хотите использовать коллекцию для выполнения запросов, задайте текущие значения переменных, определенных в этой среде.
Большинство этих значений можно найти в Менеджере WhatsApp или «WhatsApp > Начало работы» на панели управления приложения . Однако, если у вас есть токен доступа и идентификатор вашего бизнес-портфеля, вы можете использовать запросы к коллекции, чтобы получить оставшиеся значения.
токены доступа
API поддерживает как пользовательские, так и системные токены доступа. Получить пользовательский токен доступа можно, загрузив приложение на панель управления и перейдя в раздел WhatsApp > Начало работы. Также можно использовать Graph API Explorer для его генерации.
Поскольку токены доступа пользователей истекают через 24 часа, вам, вероятно, потребуется сгенерировать токен доступа системного пользователя, срок действия которого составляет до 60 дней (или навсегда, если хотите). См. раздел « Токены доступа» , чтобы узнать, как создать токен доступа системного пользователя и токен доступа системного пользователя.
Получив токен, сохраните его как текущее значение в среде.
Идентификатор бизнес-портфолио
Вы можете получить идентификатор своего бизнес-портфеля, войдя в Meta Business Suite . Идентификатор отображается в URL-адресе как
business_id . После сохранения этого значения в среде перейдите в папку WhatsApp Business Account (WABA) и выполните Get all owned WABAs . Это вернет ваш идентификатор WABA, который вы можете сохранить в своей среде, а затем использовать для определения идентификатора номера телефона вашей компании.Разрешения
API использует всего два разрешения:
whatsapp_business_management
whatsapp_business_messaging
Обратите внимание, что если вы получите токен доступа пользователя на панели управления приложения, вашему приложению автоматически будут предоставлены эти разрешения (вами от вашего имени), поэтому вы можете использовать токен для тестирования сразу же.
Для запросов, направленных на ваш бизнес-портфель, требуется разрешение business_management, которое может понадобиться и вам в зависимости от ваших бизнес-задач. Однако большинству разработчиков это разрешение не требуется, поскольку доступ к вашему бизнес-портфелю встречается нечасто, и Meta Business Suite и так предоставляет почти весь необходимый функционал.
Отладчик токенов доступа
Вы можете вставить любой сгенерированный вами токен в отладчик токенов доступа, чтобы увидеть, к какому типу он относится и какие разрешения вы предоставили своему приложению.
Пагинация
Конечные точки, возвращающие списки/коллекции, могут отображать результаты постранично (в ответе вы увидите свойства «предыдущий» и «следующий»). Используйте URL-адреса из этих свойств, чтобы получить предыдущий или следующий набор результатов. Обратите внимание, что если вы щелкнете по одной из этих ссылок в Postman, откроется новый запрос в новой вкладке, который необходимо сохранить перед запуском (иначе он не сможет прочитать ваши переменные окружения), поэтому вы можете скопировать и вставить URL-адрес и запустить запрос в той же вкладке, в которой он был получен.
Комментарии отсутствуют
Комментарии отсутствуют