WhatsApp Business API: старт, ограничения, цены

Введение

Что такое WhatsApp Business API?

• Автоматизации коммуникации — боты, чат-боты, автоматические ответы
• Массовых рассылок — уведомления, маркетинговые кампании
• Интеграции с CRM — синхронизация с системами управления клиентами
• Многопользовательской работы — несколько операторов в одном номере

Отличия от обычного WhatsApp

Провайдеры WhatsApp Business API

1. Meta (Facebook) — Официальный провайдер

• Прямая интеграция с Meta
• Нет посредников
• Полный контроль над аккаунтом

• Сложная регистрация
• Требуется бизнес-верификация
• Минимальные объемы для старта

2. Twilio

• Простая интеграция
• Хорошая документация
• Гибкие тарифы
• Поддержка множества стран

• Дороже, чем прямые провайдеры
• Комиссия за транзакции

• Входящие сообщения: $0.005 за сообщение
• Исходящие (конверсионные): $0.005 за сообщение
• Исходящие (шаблоны): $0.005–$0.09 в зависимости от страны

3. MessageBird (сейчас Sinch)

• Конкурентные цены
• Хорошая поддержка
• Простая интеграция

• Меньше документации, чем у Twilio
• Ограниченная география в некоторых регионах

• От $0.004 за сообщение (зависит от страны)

4. 360dialog

• Один из самых дешевых провайдеров
• Хорошие цены для Европы
• Простая интеграция

• Меньше известности, чем Twilio
• Ограниченная поддержка на русском

• От €0.002–0.01 за сообщение (зависит от страны)

5. Wati (WhatsApp API for Teams)

• Готовый интерфейс для операторов
• Интеграция с CRM
• Удобно для команд поддержки

• Выше цена за сообщение
• Меньше гибкости для разработчиков

6. ChatAPI

• Простая интеграция
• Хорошие цены
• Поддержка на русском

• Меньше функций, чем у крупных провайдеров

Сравнительная таблица провайдеров

Процесс регистрации и настройки

Шаг 1: Выбор провайдера

• Определите объемы сообщений
• Выберите географию (какие страны)
• Оцените бюджет
• Проверьте наличие поддержки на нужном языке

Шаг 2: Регистрация бизнес-аккаунта

• Бизнес-верификация — документы компании
• Номер телефона — отдельный номер для WhatsApp Business
• Meta Business Account — создание аккаунта в Meta Business Manager

Шаг 3: Подключение номера

# Пример регистрации через Twilio API
curl -X POST https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/Messages.json \
  --data-urlencode "From=whatsapp:+14155238886" \
  --data-urlencode "To=whatsapp:+1234567890" \
  --data-urlencode "Body=Hello from WhatsApp Business API"

Шаг 4: Верификация номера

• Получить код подтверждения по SMS или звонку
• Ввести код в панели провайдера
• Дождаться активации (обычно 1-24 часа)

Шаблоны сообщений (Template Messages)

Что такое шаблоны?

Типы шаблонов

Привет, {{1}}! Ваш заказ #{{2}} готов к выдаче.

Ваш заказ готов!

[Кнопка: Открыть заказ]
[Кнопка: Связаться с нами]

Смотрите наш новый каталог!

[Изображение]
[Кнопка: Скачать PDF]

Структура шаблона

{
  "name": "order_status_update",
  "language": "ru",
  "category": "UTILITY",
  "components": [
    {
      "type": "BODY",
      "text": "Привет, {{1}}! Ваш заказ #{{2}} готов к выдаче. Дата: {{3}}"
    },
    {
      "type": "HEADER",
      "format": "IMAGE",
      "example": {
        "header_handle": ["https://example.com/image.jpg"]
      }
    },
    {
      "type": "BUTTONS",
      "buttons": [
        {
          "type": "QUICK_REPLY",
          "text": "Открыть заказ"
        },
        {
          "type": "URL",
          "text": "Отследить",
          "url": "https://example.com/track/{{2}}"
        }
      ]
    }
  ]
}

Категории шаблонов

• MARKETING — маркетинговые сообщения (самые строгие правила)
• UTILITY — утилитарные сообщения (уведомления, транзакции)
• AUTHENTICATION — OTP коды, верификация

Ограничения шаблонов

• Длина текста:

• Количество переменных:

• Медиа:

Процесс согласования шаблонов

Почему нужно согласование?

Шаги согласования

# Пример создания шаблона через Twilio API
import requests

template_data = {
    "name": "order_status_update",
    "language": "ru",
    "category": "UTILITY",
    "components": [
        {
            "type": "BODY",
            "text": "Привет, {{1}}! Ваш заказ #{{2}} готов."
        }
    ]
}

response = requests.post(
    "https://content.twilio.com/v1/Content",
    auth=("AccountSid", "AuthToken"),
    json=template_data
)

• PENDING — ожидает модерации
• APPROVED — одобрен, можно использовать
• REJECTED — отклонен, нужно исправить
• PAUSED — приостановлен (нарушение правил)

• UTILITY/AUTHENTICATION: 15 минут — 2 часа
• MARKETING: 2-24 часа (иногда до 48 часов)

• Соответствие правилам WhatsApp Business Policy
• Отсутствие спама
• Корректность использования переменных
• Соответствие категории шаблона

Типичные причины отклонения

• Спам-контент — реклама без согласия пользователя
• Некорректная категория — маркетинговый контент в UTILITY
• Неправильные переменные — использование переменных не по назначению
• Нарушение формата — слишком длинный текст, неправильная структура
• Запрещенные слова — использование запрещенных терминов

Как ускорить одобрение?

• Используйте правильную категорию:

• Следуйте best practices:

• Избегайте спама:

• Тестируйте на sandbox:

Ограничения WhatsApp Business API

Окно 24 часов

Пользователь написал → [24 часа] → Можно отправлять только шаблоны

• Настройте автоматические ответы
• Используйте шаблоны для важных уведомлений
• Мониторьте время ответа

Rate Limits

Quality Rating

• GREEN — отличный рейтинг, нет ограничений
• YELLOW — предупреждение, возможны ограничения
• RED — серьезные проблемы, строгие ограничения
• FLAGGED — аккаунт заблокирован

• Процент блокировок пользователями
• Процент жалоб
• Качество шаблонов
• Соответствие правилам

Ограничения по странам

• Индия: строгие правила для маркетинга
• Бразилия: требуется дополнительная верификация
• Россия: возможны ограничения из-за санкций

Цены на WhatsApp Business API

Структура ценообразования

• Провайдера (BSP)
• Страны получателя
• Типа сообщения (входящее/исходящее)
• Категории шаблона (MARKETING дороже)

Примеры цен по странам

Расчет стоимости

10,000 сообщений × $0.005 = $50/месяц

5,000 UTILITY × $0.005 = $25
5,000 MARKETING × $0.015 = $75
Итого: $100/месяц

Скрытые расходы

• Регистрация номера: $1-5/месяц
• Верификация: бесплатно (но время = деньги)
• Разработка интеграции: зависит от сложности
• Поддержка: часто включена, но может быть платной

Интеграция WhatsApp Business API

Пример интеграции с Python

import requests
from twilio.rest import Client

class WhatsAppBot:
    def __init__(self, account_sid, auth_token, from_number):
        self.client = Client(account_sid, auth_token)
        self.from_number = from_number
    
    def send_message(self, to, message):
        """Отправка обычного сообщения (в течение 24 часов)"""
        message = self.client.messages.create(
            body=message,
            from_=f'whatsapp:{self.from_number}',
            to=f'whatsapp:{to}'
        )
        return message.sid
    
    def send_template(self, to, template_name, parameters):
        """Отправка шаблона"""
        message = self.client.messages.create(
            from_=f'whatsapp:{self.from_number}',
            to=f'whatsapp:{to}',
            content_sid=template_name,  # SID одобренного шаблона
            content_variables=json.dumps(parameters)
        )
        return message.sid
    
    def handle_webhook(self, request):
        """Обработка входящих сообщений"""
        incoming_message = request.form.get('Body', '')
        from_number = request.form.get('From', '')
        
        # Логика обработки
        response = self.process_message(incoming_message)
        
        # Отправка ответа
        self.send_message(from_number, response)
        
        return 'OK'

Пример интеграции с Node.js

const twilio = require('twilio');
const express = require('express');

const app = express();
const client = twilio(process.env.ACCOUNT_SID, process.env.AUTH_TOKEN);

// Отправка сообщения
async function sendMessage(to, message) {
    const msg = await client.messages.create({
        body: message,
        from: whatsapp:${process.env.FROM_NUMBER},
        to: whatsapp:${to}
    });
    return msg.sid;
}

// Отправка шаблона
async function sendTemplate(to, templateName, parameters) {
    const msg = await client.messages.create({
        from: whatsapp:${process.env.FROM_NUMBER},
        to: whatsapp:${to},
        contentSid: templateName,
        contentVariables: JSON.stringify(parameters)
    });
    return msg.sid;
}

// Webhook для входящих сообщений
app.post('/webhook', (req, res) => {
    const incomingMessage = req.body.Body;
    const fromNumber = req.body.From;
    
    // Обработка сообщения
    const response = processMessage(incomingMessage);
    
    // Отправка ответа
    sendMessage(fromNumber, response);
    
    res.send('OK');
});

app.listen(3000, () => {
    console.log('WhatsApp bot running on port 3000');
});

Webhook настройка

# Установка webhook URL
from twilio.rest import Client

client = Client(account_sid, auth_token)

# Установка webhook для входящих сообщений
incoming_phone_number = client.incoming_phone_numbers('PN...').update(
    sms_url='https://your-domain.com/webhook',
    sms_method='POST'
)

Best Practices

1. Оптимизация стоимости

• Используйте UTILITY вместо MARKETING когда возможно
• Группируйте уведомления — одно сообщение вместо нескольких
• Кэшируйте шаблоны — не создавайте дубликаты
• Мониторьте рейтинг качества — GREEN = меньше ограничений

2. Улучшение доставляемости

• Быстрые ответы — отвечайте в течение 24 часов
• Качественные шаблоны — четкие, релевантные сообщения
• Персонализация — используйте переменные правильно
• Оптимизация времени — отправляйте в удобное время для пользователя

3. Соблюдение правил

• Не спамьте — только релевантные сообщения
• Получайте согласие — для маркетинга требуется opt-in
• Уважайте отказы — обрабатывайте блокировки
• Следуйте политике — читайте правила Meta регулярно

4. Мониторинг и аналитика

# Отслеживание метрик
class WhatsAppAnalytics:
    def __init__(self, client):
        self.client = client
    
    def get_message_status(self, message_sid):
        """Получение статуса сообщения"""
        message = self.client.messages(message_sid).fetch()
        return {
            'status': message.status,
            'date_sent': message.date_sent,
            'error_code': message.error_code
        }
    
    def track_delivery_rate(self, messages):
        """Отслеживание доставляемости"""
        delivered = sum(1 for m in messages if m.status == 'delivered')
        total = len(messages)
        return delivered / total if total > 0 else 0

Типичные проблемы и решения

Проблема 1: Шаблон отклонен

• Проверьте категорию шаблона
• Убедитесь, что нет спам-контента
• Исправьте форматирование
• Отправьте заново

Проблема 2: Высокая стоимость

• Используйте UTILITY вместо MARKETING
• Группируйте сообщения
• Выберите более дешевого провайдера
• Оптимизируйте частоту отправки

Проблема 3: Низкая доставляемость

• Улучшите качество шаблонов
• Снизьте количество жалоб
• Оптимизируйте время отправки
• Улучшите релевантность сообщений

Проблема 4: Долгое согласование шаблонов

• Используйте простые шаблоны
• Правильно категоризируйте
• Планируйте заранее (создавайте шаблоны заранее)
• Используйте sandbox для тестирования

Альтернативы WhatsApp Business API

1. Telegram Bot API

• Бесплатно
• Простая интеграция
• Нет ограничений на шаблоны

• Меньше пользователей в некоторых регионах
• Нет официальной бизнес-платформы

2. Viber Business Messages

• Популярен в некоторых странах
• Бизнес-инструменты

• Ограниченная география
• Меньше функций

3. SMS через провайдеров

• Универсальность
• Нет ограничений на шаблоны

• Дороже
• Меньше функций (нет медиа, кнопок)

Заключение

• Выбор провайдера — зависит от бюджета, географии и требований
• Шаблоны — обязательны для массовых рассылок, требуют согласования
• Ограничения — окно 24 часов, rate limits, качественный рейтинг
• Стоимость — варьируется от $0.002 до $0.09 за сообщение

• Начните с простых шаблонов UTILITY
• Выберите провайдера с хорошей поддержкой
• Тестируйте на sandbox перед продакшеном
• Мониторьте рейтинг качества
• Оптимизируйте стоимость через правильную категоризацию