Отправка шаблонов, кодов OTP, уведомлений и массовых рассылок в WhatsApp из вашей системы (сайт, приложение, CRM): ключ API, эндпоинты, стоимость, 24-часовое окно, вебхуки, ошибки и примеры кода.

Статьи по документу

• Начало работы с WhatsApp API: ключ API, account_id и channel_id WhatsApp API отправляет клиенту сообщение WhatsApp из собственной системы Вашей компании (сайт, приложение, CRM). Нужны: канал WhatsApp типа Cloud API, одобренный шаблон, ключ API, account_id и channel_id. Запросы идут на https://api.clomni.ai с заголовком Authorization: Bearer <API_ACARI>.
• WhatsApp API: стоимость сообщения, 24-часовое окно и fallback_template Meta берёт плату за каждое сообщение: шаблон UTILITY и AUTHENTICATION 0.036 AZN, MARKETING 0.165 AZN, свободный текст внутри 24-часового окна бесплатно. Clomni не берёт доплату. Окно открывает клиент. Отправляйте text вместе с fallback_template: если окно открыто, текст уходит бесплатно (sent_as: session), если закрыто, уходит шаблон (sent_as: template).
• Отправка сообщений через WhatsApp API: код OTP, шаблон и текст POST /v1/accounts/{account_id}/whatsapp/messages: передайте channel_id, phone_number и template (name, language, parameters) или text. Название, язык и переменные шаблона возвращает GET /v1/accounts/{account_id}/whatsapp/templates. Ответ 201: id сообщения и sent_as.
• Массовая отправка через WhatsApp API (bulk_messages) POST /v1/accounts/{account_id}/whatsapp/bulk_messages отправляет один шаблон одним запросом максимум на 1000 номеров, ответ 202 и batch_id. Результат можно читать 7 дней через GET /v1/accounts/{account_id}/whatsapp/bulk_messages/{batch_id}. Отправлять может только администратор.
• WhatsApp API: отслеживание статуса доставки сообщения Состояние сообщения читается через GET /v1/accounts/{account_id}/whatsapp/messages/{message_id}: sent, delivered, read, failed. Удобнее вебхук: в «Settings › Workspace settings › Integrations › Webhook» выберите событие message_updated («Message updated»). Отчёт на Ваш адрес по каждому сообщению: добавьте в отправку status_callback (url, after_seconds, on_change, secret).
• Ошибки WhatsApp API: 401, 403, 404, 422 и ошибки Meta Ошибка возвращается в поле error в JSON. 401: ключа нет или он неверный. 403: владелец ключа не состоит в канале. 404: неверный channel_id или id сообщения. 422: в запросе чего-то не хватает, окно закрыто, шаблон не найден или неверный номер. Если Meta отклонит сообщение, оно получает статус failed, причина в external_error.
• Сообщения из API в панели: почему диалог становится «решённым» Сообщение, отправленное через API, записывается в диалог клиента, а диалог автоматически становится решённым (resolved): его нет среди открытых, звука нет. Как только клиент отвечает, диалог открывается. Чтобы диалог оставался открытым, передайте conversation_status: open или pending.