Telinfy MCP server

공식

프로그래밍 방식으로 SMS, WhatsApp 및 RCS 메시지를 전송하며 DLT 규정을 준수합니다. 연락처를 관리하고, 캠페인을 예약하며, 전송 보고서를 추적합니다.

GitHub

문서

Telinfy MCP 통합 가이드

AI 어시스턴트와 Telinfy MCP 서버를 연결하고 사용하는 방법

Telinfy MCP 서버는 Telinfy의 SMS, WhatsApp, RCS 메시징 기능에 대한 프로그래밍 방식의 접근을 제공하여 AI 어시스턴트가 사용자를 대신하여 메시지를 보내고, 연락처를 관리하고, 캠페인을 예약하고, 보고서를 조회할 수 있도록 합니다.

MCP란 무엇인가요?

모델 컨텍스트 프로토콜(MCP)은 AI 애플리케이션이 MCP 호환 데이터 소스 및 도구에 안전하게 연결할 수 있도록 하는 개방형 표준입니다. MCP를 AI 애플리케이션용 USB-C 포트라고 생각하시면 됩니다. AI 앱을 다양한 서비스에 연결하는 표준화된 방법입니다.

Telinfy MCP 서버

Telinfy MCP 서버는 Telinfy 메시징 플랫폼에 대한 접근을 제공하는 안전하고 인증된 서비스입니다.

기본 서버 URL: https://mcp.telinfy.com/sse

인증 필요

Telinfy MCP 서버를 사용하려면 다음이 필요합니다:

  • Telinfy 사용자 이름
  • Telinfy 비밀번호
  • API 자격 증명 (로그인 후 자동으로 조회됨)

사용 가능한 도구

Telinfy MCP 서버는 포괄적인 메시징 및 캠페인 관리 도구를 제공합니다:

SMS 작업

  1. send_sms - DLT 규정을 준수하여 SMS 메시지 보내기
  2. schedule_sms - 향후 발송을 위한 SMS 캠페인 예약하기
  3. scheduleDynamicCampaign - Excel 파일과 템플릿 변수를 사용하여 동적 SMS 캠페인 예약하기
  4. get_sms_schedule - 예약된 모든 SMS 캠페인 보기
  5. fetch_sms_campaign_report - SMS 캠페인에 대한 상세 보고서 받기

WhatsApp 작업

  1. send_whatsapp_campaign - 미리 생성된 템플릿을 사용하여 WhatsApp 메시지 보내기
  2. whatsapp_campaign - 모든 WhatsApp 캠페인 나열하기
  3. fetch_whatsapp_smart_report - 날짜 필터링을 사용하여 WhatsApp 캠페인 보고서 받기

RCS 작업

  1. fetch_rcs_report - 날짜 필터링을 사용하여 RCS 메시지 보고서 조회하기

연락처 관리

  1. create_phonebook - 연락처가 포함된 새 전화번호부 그룹 만들기
  2. get_phonebook_groups - 모든 전화번호부 그룹 나열하기
  3. get_group_contacts - 특정 그룹 내 연락처 보기
  4. edit_contact - 연락처 정보 업데이트하기
  5. toggle_contact_status - 그룹 내 연락처 활성화/비활성화하기
  6. delete_contact_group - 전화번호부 그룹 제거하기

메시지 보고

  1. getMessageReport - 보낸 메시지에 대한 메시지 발송 보고서 및 상태 가져오기

인증

  1. login_to_telinfy - Telinfy 플랫폼에 인증하고 세션 설정하기

통신 프로토콜

Telinfy MCP 서버는 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 캠페인은 템플릿 ID와 발신자 이름을 사용한 DLT(분산 원장 기술) 규정 준수를 지원하여 인도 내 규제 준수를 보장합니다.

동적 캠페인

변수 치환 기능이 있는 Excel 파일을 사용하여 개인화된 SMS 캠페인을 예약할 수 있으며, 대량 개인화 메시징에 적합합니다.

멀티채널 메시징

  • SMS - 프로모션 및 트랜잭션 경로
  • WhatsApp - 템플릿 기반 비즈니스 메시징
  • RCS - 리치 커뮤니케이션 서비스

포괄적인 보고

메시지 발송, 캠페인 성과를 추적하고 날짜 필터링을 통해 상세 보고서를 생성합니다.

연락처를 그룹으로 구성하고, 연락처를 활성화/비활성화하며, 깔끔한 전화번호부 목록을 유지 관리합니다.

보안 및 인증

  • 모든 API 호출은 Telinfy 자격 증명을 사용하여 인증됩니다.
  • 초기 로그인 후 안전한 토큰 기반 인증
  • 대화 기간 동안 세션이 유지됩니다.
  • AI 어시스턴트는 자격 증명을 저장하지 않습니다.

지원 및 리소스

문제 해결

인증 문제

로그인 문제가 발생하는 경우:

  1. 사용자 이름과 비밀번호가 올바른지 확인하세요.
  2. 계정에 API 접근이 활성화되어 있는지 확인하세요.
  3. Telinfy 지원팀에 문의하여 계정에 MCP 접근 권한이 있는지 확인하세요.

연결 문제

MCP 서버가 연결되지 않는 경우:

  1. 서버 URL이 정확히 https://mcp.telinfy.com/sse인지 확인하세요.
  2. 인터넷 연결을 확인하세요.
  3. AI 클라이언트 설정에서 MCP 서버를 다시 연결해 보세요.

메시지 발송 문제

메시지가 전송되지 않는 경우:

  1. Telinfy 계정에 충분한 크레딧이 있는지 확인하세요.
  2. DLT 템플릿 ID가 올바르게 등록되었는지 확인하세요.
  3. 발신자 이름이 Telinfy 계정에서 승인되었는지 확인하세요.
  4. 전화번호가 올바른 형식인지 확인하세요.

모범 사례

  1. 항상 먼저 로그인하세요 - 각 세션 시작 시 인증하세요.
  2. 올바른 템플릿 ID 사용 - DLT 템플릿이 메시지 내용과 일치하는지 확인하세요.
  3. 전화번호 형식 확인 - 10자리 인도 번호 또는 국가 코드가 포함된 국제 형식을 사용하세요.
  4. 캠페인 보고서 확인 - 발송 상태를 정기적으로 모니터링하세요.
  5. 연락처 효율적으로 관리 - 전화번호부 그룹을 체계적으로 유지하세요.
  6. 대량 발송 전 테스트 - 대규모 캠페인 전에 테스트 메시지를 보내세요.

예시 워크플로우

캠페인 발송을 위한 전체 워크플로우는 다음과 같습니다:

  1. 인증
Log me into Telinfy with username "myuser" and password "mypass"
  1. 연락처 그룹 만들기
Create a phonebook group "Spring Sale 2024" with my customer list
  1. 캠페인 예약하기
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"
  1. 결과 모니터링
Show me the delivery report for the Spring Sale campaign

고급 기능

동적 변수 치환

Excel 파일을 사용하여 대규모로 개인화된 메시지를 보냅니다:

  • 열이 Mobile, Name, OrderID, Amount인 Excel 업로드
  • 변수 매핑: {{1}} = Name, {{2}} = OrderID, {{3}} = Amount
  • 템플릿: "안녕하세요 {{1}}님, 주문 {{2}} (Rs.{{3}})이(가) 확인되었습니다."

다중 경로 SMS

  • 경로 0: 프로모션 메시지
  • 경로 1: 트랜잭션 메시지 (OTP, 알림)

유니코드 지원

유니코드 모드를 활성화하여 지역 언어로 메시지를 보냅니다.

시작하기 체크리스트

  • Telinfy MCP 서버를 AI 어시스턴트에 연결하세요.
  • Telinfy 자격 증명으로 인증하세요.
  • 활성 발신자 이름과 DLT 템플릿이 있는지 확인하세요.
  • 계정 잔액과 크레딧을 확인하세요.
  • 대량 캠페인 전에 단일 SMS로 테스트하세요.
  • 체계적인 전화번호부 그룹을 만드세요.
  • 최적의 타이밍을 위해 예약 캠페인을 설정하세요.
  • 정기적으로 보고서를 모니터링하세요.

자세한 API 사양 및 매개변수 참조는 Telinfy API 문서를 참조하거나 계정 관리자에게 문의하세요.