Telinfy MCP server

Руководство по интеграции Telinfy MCP

Как подключить и использовать Telinfy MCP server с AI-ассистентами

Telinfy MCP server предоставляет программный доступ к возможностям SMS, WhatsApp и RCS от Telinfy, позволяя AI-ассистентам отправлять сообщения, управлять контактами, планировать кампании и получать отчёты от вашего имени.

---

Что такое MCP?

Протокол Model Context Protocol (MCP) — это открытый стандарт, который позволяет AI-приложениям безопасно подключаться к совместимым с MCP источникам данных и инструментам. Представьте MCP как порт USB-C для AI-приложений — стандартизированный способ подключения AI-приложений к различным сервисам.

---

Telinfy MCP Server

Telinfy MCP server — это защищённый аутентифицированный сервис, предоставляющий доступ к вашей платформе обмена сообщениями Telinfy.

Базовый URL сервера: https://mcp.telinfy.com/sse

Требуется аутентификация

Для использования Telinfy MCP server вам понадобятся:

• Имя пользователя Telinfy
• Пароль Telinfy
• Учётные данные API (автоматически получаются после входа)

---

Доступные инструменты

Telinfy MCP server предлагает комплексные инструменты для обмена сообщениями и управления кампаниями:

Операции SMS

1. send_sms — Отправка SMS-сообщений с соблюдением требований DLT
2. schedule_sms — Планирование SMS-кампаний для будущей отправки
3. scheduleDynamicCampaign — Планирование динамических SMS-кампаний с использованием файлов Excel и переменных шаблона
4. get_sms_schedule — Просмотр всех запланированных SMS-кампаний
5. fetch_sms_campaign_report — Получение подробных отчётов по SMS-кампаниям

Операции WhatsApp

6. send_whatsapp_campaign — Отправка сообщений WhatsApp с использованием заранее созданных шаблонов
7. whatsapp_campaign — Список всех кампаний WhatsApp
8. fetch_whatsapp_smart_report — Получение отчётов по кампаниям WhatsApp с фильтрацией по дате

Операции RCS

9. fetch_rcs_report — Получение отчётов по сообщениям RCS с фильтрацией по дате

Управление контактами

10. create_phonebook — Создание новых групп телефонной книги с контактами
11. get_phonebook_groups — Список всех групп телефонной книги
12. get_group_contacts — Просмотр контактов в конкретной группе
13. edit_contact — Обновление информации о контактах
14. toggle_contact_status — Включение/отключение контактов в группе
15. delete_contact_group — Удаление групп телефонной книги

Отчётность по сообщениям

16. getMessageReport — Получение отчётов о доставке сообщений и статусе отправленных сообщений

Аутентификация

17. login_to_telinfy — Аутентификация и установление сеанса с платформой Telinfy

---

Проводной протокол

Telinfy MCP server использует протокол SSE (Server-Sent Events):

SSE (Server-Sent Events) — /sse

• URL: https://mcp.telinfy.com/sse
• Официальная версия спецификации MCP
• Поддерживается Claude, Windsurf, Cursor и другими MCP-клиентами
• Рекомендуется для всех интеграций

---

Инструкции по настройке

Для Claude Desktop/Web:

1. Перейдите в настройки Claude
2. Перейдите в раздел «Интеграции» или «Подключения»
3. Добавьте новый MCP-сервер с этими данными:
   • Имя: Telinfy
     • URL сервера: https://mcp.telinfy.com/sse
4. Сохраните конфигурацию

Для Claude Code (командная строка):

claude mcp add -s user -t http telinfy https://mcp.telinfy.com/sse

Для Windsurf, Cursor или других MCP-клиентов:

Добавьте эту конфигурацию в файл настроек MCP:

{
  "mcpServers": {
    "telinfy": {
      "serverUrl": "https://mcp.telinfy.com/sse"
    }
  }
}

---

Использование Telinfy MCP

Первоначальная настройка

После подключения MCP-сервера вам потребуется аутентифицироваться с помощью ваших учётных данных Telinfy:

Claude, please log me into Telinfy using my username and password.

AI-ассистент будет использовать инструмент login_to_telinfy для установления безопасного сеанса.

Примеры использования

Отправка SMS-кампании

Send an SMS to +919876543210 with the message "Your OTP is 123456" 
using sender name "NOTIFY" and template ID "1234567890"

Планирование маркетинговой кампании

Schedule an SMS campaign named "Weekend Sale" to be sent tomorrow at 10 AM 
to these numbers: +919876543210, +919876543211 with the message 
"Flash Sale this weekend! 50% off. Visit now."

Создание группы контактов

Create a new phonebook group called "VIP Customers" with these contacts:
- John Doe, +919876543210
- Jane Smith, +919876543211

Отправка сообщений WhatsApp

Send a WhatsApp campaign using my "order_confirmation" template 
to +919876543210 with customer name "John" and order number "ORD123"

Получение отчётов по кампаниям

Show me the SMS campaign report for campaign ID "12345"

Получение статуса доставки сообщений

Get the delivery status for all messages sent today

---

Ключевые возможности

Соответствие DLT

Все SMS-кампании поддерживают соответствие DLT (Distributed Ledger Technology) с идентификаторами шаблонов и именами отправителей, что обеспечивает соблюдение нормативных требований в Индии.

Динамические кампании

Планируйте персонализированные SMS-кампании с помощью файлов Excel с подстановкой переменных — идеально для массовой персонализированной рассылки.

Многоканальный обмен сообщениями

• SMS — Промо- и транзакционные маршруты
• WhatsApp — Бизнес-сообщения на основе шаблонов
• RCS — Rich Communication Services

Комплексная отчётность

Отслеживайте доставку сообщений, эффективность кампаний и создавайте подробные отчёты с фильтрацией по дате.

Управление контактами

Организуйте контакты в группы, включайте/отключайте контакты и поддерживайте чистоту списков телефонной книги.

---

Безопасность и аутентификация

• Все вызовы API аутентифицируются с использованием ваших учётных данных Telinfy
• Безопасная аутентификация на основе токенов после первоначального входа
• Сеансы поддерживаются в течение всего разговора
• Учётные данные не сохраняются AI-ассистентом

---

Поддержка и ресурсы

• Панель управления Telinfy: https://telinfy.com
• Документация API: Обратитесь в службу поддержки Telinfy за подробной документацией API
• Протокол MCP: https://modelcontextprotocol.io
• Поддержка: Свяжитесь с вашим менеджером по работе с клиентами Telinfy

---

Устранение неполадок

Проблемы с аутентификацией

Если у вас возникли проблемы со входом:

1. Проверьте правильность имени пользователя и пароля
2. Убедитесь, что для вашей учётной записи включён доступ к API
3. Обратитесь в службу поддержки Telinfy, чтобы убедиться, что ваша учётная запись имеет доступ к MCP

Проблемы с подключением

Если MCP-сервер не подключается:

1. Проверьте, что URL сервера точно такой: https://mcp.telinfy.com/sse
2. Проверьте ваше интернет-соединение
3. Попробуйте переподключить MCP-сервер в настройках вашего AI-клиента

Проблемы с доставкой сообщений

Если сообщения не отправляются:

1. Убедитесь, что на вашем счёте Telinfy достаточно кредитов
2. Проверьте, что идентификаторы шаблонов DLT правильно зарегистрированы
3. Убедитесь, что имена отправителей одобрены в вашей учётной записи Telinfy
4. Подтвердите, что номера телефонов указаны в правильном формате

---

Рекомендации

1. Всегда сначала входите в систему — Аутентифицируйтесь в начале каждого сеанса
2. Используйте правильные идентификаторы шаблонов — Убедитесь, что шаблоны DLT соответствуют содержимому вашего сообщения
3. Проверяйте форматы телефонов — Используйте 10-значные индийские номера или международный формат с кодом страны
4. Проверяйте отчёты по кампаниям — Регулярно отслеживайте статус доставки
5. Эффективно управляйте контактами — Поддерживайте организованность групп телефонной книги
6. Тестируйте перед массовой отправкой — Отправляйте тестовые сообщения перед крупными кампаниями

---

Пример рабочего процесса

Вот полный рабочий процесс отправки кампании:

1. Аутентификация

   Log me into Telinfy with username "myuser" and password "mypass"
   

2. Создание группы контактов

   Create a phonebook group "Spring Sale 2024" with my customer list
   

3. Планирование кампании

   Schedule an SMS campaign "Spring Sale Announcement" to the "Spring Sale 2024" 
   group for tomorrow at 9 AM with message "Exclusive Spring Sale! 40% off all items. 
   Shop now at example.com" using sender "RETAIL" and template "1234567890"
   

4. Мониторинг результатов

   Show me the delivery report for the Spring Sale campaign
   

---

Расширенные возможности

Динамическая подстановка переменных

Используйте файлы Excel для отправки персонализированных сообщений в масштабе:

• Загрузите Excel со столбцами: Mobile, Name, OrderID, Amount
• Сопоставьте переменные: {{1}} = Name, {{2}} = OrderID, {{3}} = Amount
• Шаблон: «Привет, {{1}}, ваш заказ {{2}} на сумму {{3}} подтверждён»

Многомаршрутная SMS

• Маршрут 0: Промо-сообщения
• Маршрут 1: Транзакционные сообщения (OTP, оповещения)

Поддержка Unicode

Отправляйте сообщения на региональных языках, включив режим Unicode.

---

Контрольный список для начала работы

• Подключите Telinfy MCP server к вашему AI-ассистенту
• Аутентифицируйтесь с помощью ваших учётных данных Telinfy
• Убедитесь, что у вас есть активные имена отправителей и шаблоны DLT
• Проверьте баланс и кредиты вашей учётной записи
• Протестируйте отправку одного SMS перед массовыми кампаниями
• Создайте организованные группы телефонной книги
• Настройте запланированные кампании для оптимального времени отправки
• Регулярно отслеживайте отчёты

---

Для получения подробных спецификаций API и справочной информации по параметрам обратитесь к документации Telinfy API или свяжитесь с вашим менеджером по работе с клиентами.