API и библиотеки Wazzapo

Зачем нужен API

• Заявка с сайта сразу становится сделкой в воронке, а клиенту уходит сообщение в WhatsApp.
• Ваша программа (учёт, интернет-магазин, запись к врачу) сама отправляет напоминания и статусы заказов.
• Входящие сообщения, новые сделки и смена этапа приходят на ваш сервер уведомлениями (вебхуками).
• Контакты, диалоги, сделки и задачи можно читать и менять из своей системы.

Где взять ключ

1. Откройте в кабинете раздел «API» и нажмите «Создать ключ».
2. Выберите окружение: «Боевое» для работы или «Тестовое» для проверки интеграции.
3. Оставьте «Полный доступ ко всему API» или отметьте только нужные права: отправка сообщений, контакты, шаблоны, сделки, задачи, диалоги и другие.
4. Скопируйте ключ: он показывается один раз. Передавайте его программисту так же бережно, как пароль.

Ключ передаётся в каждом запросе в заголовке X-API-Key. Можно ограничить ключ списком разрешённых IP-адресов.

Тестовый ключ

• Ключ с началом wz_test_ ничего не отправляет клиентам и не меняет данные в кабинете.
• Ответы такие же, как у боевого ключа, а ошибки те же: неверный номер, несуществующий шаблон, повтор запроса.
• Когда интеграция готова, замените тестовый ключ на боевой wz_live_, больше ничего менять не нужно.

Библиотеки для PHP, JavaScript и Python

Официальные библиотеки Wazzapo с открытым кодом (лицензия MIT). Программист ставит библиотеку одной командой:

Библиотека:

• сама повторяет запрос, если сервер занят или пропала связь;
• не отправит одно сообщение дважды при повторе;
• сообщает понятные ошибки, например «прошло 24 часа, нужен шаблон»;
• проверяет подпись уведомлений, чтобы чужой сервер не прислал вам поддельное событие.

Примеры первого запроса на каждом языке в документации.

Postman и MCP

Postman (программа для проверки запросов): готовая коллекция со всеми методами, скачать файл. Импортируйте его и вставьте тестовый ключ.

MCP (подключение для нейросетей): Claude и другие ИИ-помощники работают с вашими диалогами, шаблонами, сделками и задачами по вашей просьбе. Настройка в кабинете: раздел «API», вкладка «MCP».

Сколько стоит и лимиты

API входит в платные тарифы. Число сообщений тариф не ограничивает, ограничено число запросов к API:

Частые вопросы