Откройте вкладку Отчеты.
Создавайте запланированные отчеты CSV для отслеживания использования SMS и WhatsApp, мониторинга квот и анализа потребления по группам.
Экспорт данных об использовании транзакций обеспечивает видимость активности SMS и WhatsApp по всей учетной записи, включая приобретенные количества, общее потребление и использование на уровне групп. Эти операции экспорта включают следующее:
- Аутентификация SMS
- Доставка SMS
- Аутентификация через WhatsApp
- Транзакции доставки WhatsApp .
Экспорты создаются как запланированные снимки, а не запросы в реальном времени. Используйте расписания для постоянного мониторинга или вручную подготовьте экспорт для его повторного создания, когда вам нужны обновленные данные немедленно.
Как работают экспорты данных
Данные транзакций экспортируются как файлы CSV в определенном диапазоне дат и с указанными фильтрами.
- Экспорты создаются асинхронно и не в реальном времени.
- Экспорты обновляются по настроенному расписанию.
- Выбор Подготовить повторно создает экспорт с последними доступными данными.
Каждая строка в CSV представляет отдельное соглашение и включает данные об использовании транзакций SMS и WhatsApp .
Создание отчета об использовании транзакций
Создайте отчет в формате CSV на вкладке Отчеты.
-
-
Нажмите Новый экспорт.
-
Выберите Использование транзакций.
-
Определите экспорт:
- Выберите диапазон дат.
- Примените фильтры, включая одну или несколько Групп при необходимости.
-
Нажмите Выбрать столбцы и выберите данные для включения.
Для использования транзакций SMS и WhatsApp разверните Дополнение в разделе «Доступные столбцы» и включите следующее:
- Приобретенное количество для надстройки доставки сообщений — итоговое количество приобретенных транзакций.
- Дата начала для дополнения доставки сообщений — годовая дата вступления в силу, когда была применена квота транзакций.
- Количество использованных SMS OTP — транзакции, используемые для аутентификации на основе SMS.
- Количество использования SMS для доставки соглашений — транзакции, используемые для доставки ссылок на соглашения через SMS.
- Количество использованных WhatsApp OTP — транзакции, используемые для аутентификации через WhatsApp.
- Израсходованное количество сообщений WhatsApp для доставки соглашений — транзакции, используемые для доставки ссылок на соглашения через WhatsApp.
Чтобы включить отчетность на уровне группы, также добавьте столбец Группа отправителя.
-
Нажмите Сохранить и укажите имя для экспорта.
Экспорт создается асинхронно и появляется в списке Последние отчеты после завершения.
Настройте точные данные на уровне группы
Использование на уровне группы требует как фильтрации, так и выбора столбцов.
- Примените один или несколько групповых фильтров при определении экспорта.
- Включите столбец Группа отправителя в экспорт.
Если любое из требований не выполнено, использование на уровне группы не будет точно представлено в экспортированных данных.
Обеспечьте точность данных об использовании контракта
Для отчетности за нужный период действия контракта:
- Используйте дату вступления в силу телефонной квоты (начало) в качестве даты начала отчета.
- Это значение доступно в Параметры учетной записи > Параметры отправки
Использование правильной даты начала гарантирует, что все транзакции в рамках текущего контракта включены и что итоги использования и сводки на уровне группы точны.
Планирование отчета
Запланируйте отчет для автоматического создания обновленных данных транзакций.
-
Создайте новый экспорт или отредактируйте существующий.
-
Выберите многоточие для экспорта, который хотите запланировать, и выберите Запланировать из выпадающего меню.
-
Настройте расписание, определив:
- Частота расписания (ежедневно, еженедельно, ежемесячно)
- На какие адреса электронной почты отправлять отчет
- Дополнительное сообщение
-
Сохраните расписание.
Запланированные отчеты создаются автоматически и могут быть загружены из списка Последние отчеты или доставлены по электронной почте.
Обновите экспорт с последними данными
Чтобы обновить экспорт:
- Нажмите Подготовить, чтобы незамедлительно повторно создать операцию экспорта.
- Или дождитесь следующего запланированного запуска.
- При необходимости вы также можете создать новый экспорт с теми же параметрами.
Загрузите экспорт с помощью API
Получите последний созданный экспорт с помощью API.
- Конечная точка: POST /api/rest/v6/reportDownload
- Обязательный параметр: scheduleId
Эта конечная точка:
- Требует создания расписания экспорта в пользовательском интерфейсе отчетов.
- Возвращает URL-адрес для загрузки только для самых последних файлов CSV.
- Не создает новый экспорт по запросу.
Если экспорт не был обновлен, возвращается ранее созданный CSV-файл.
При загрузке больших CSV-файлов обработка может занять больше времени, поскольку необходимо подготовить все записи. Настройте тайм-аут клиента не менее 5 минут, чтобы обеспечить успешную загрузку.
Доступность и хранение экспорта
- Экспортированные CSV-файлы хранятся в течение 7 дней.
- Через 7 дней срок действия файла истекает, и он больше не доступен для загрузки.
- Чтобы получить доступ к обновленным данным, повторно создайте операцию экспорта, нажав Подготовить, или дождитесь следующего запланированного запуска.
Важная информация
- Экспорты должны быть созданы или запланированы, прежде чем к ним можно будет получить доступ через API.
- Через API доступен только самый последний CSV-файл для расписания.
- Отчетность на уровне группы требует наличия обоих следующих элементов:
- Фильтр «Группа»
- Столбец Группа отправителя
- Использование корректной даты вступления в силу телефонной квоты (начало) обязательно для ведения точной отчетности на уровне контракта.
- Срок действия экспортированных файлов истекает через 7 дней, и при необходимости их нужно создать заново.