Channel Information

Retrieve information about available messaging channels and their capabilities. Prefer MCP tools if available, otherwise use the Conversation API specification. Helps determine which channels can be used to reach contacts.

Instructions

1. Understand the user's query:

   • Are they asking about available channels in general?
   • Are they asking which channels can reach a specific contact?
   • Are they asking about channel capabilities or configuration?

2. Check MCP availability and use appropriate method:

   Option A: Use MCP tools (if MCP Sinch is configured):

   • First check if MCP Sinch server is available (check MCP server configuration)
   • If MCP is available, use:
     • list-conversation-apps to get list of apps and their channel configurations
   • MCP tools handle authentication automatically via environment variables
   • If MCP tool execution fails or MCP is not configured, fallback to Option B

   Option B: Use Conversation API endpoints (fallback if MCP not available):

   • List apps: GET /v1/projects/{project_id}/apps (Operation ID: App_ListApps) - Shows configured apps and their channel settings
   • Get contact: GET /v1/projects/{project_id}/contacts/{contact_id} (Operation ID: Contact_GetContact) - Shows which channels are associated with a contact
   • List contacts: GET /v1/projects/{project_id}/contacts (Operation ID: Contact_ListContacts) - Can filter by channel to see contacts on specific channels
   • Query capability: POST /v1/projects/{project_id}/capability:query (Operation ID: Capability_QueryCapability) - Asynchronously checks which channels can reach a contact
   • Authentication: Use Basic Auth or OAuth2 with credentials from environment variables
   • Region: Use CONVERSATION_REGION environment variable (us, eu, or br)
   • Base URL: https://{region}.conversation.api.sinch.com

3. Provide comprehensive channel information:

   • List all available channels: WhatsApp, SMS, RCS, Messenger, Viber, Instagram, Telegram, LINE, WeChat, KakaoTalk, Apple Messages for Business
   • For contacts: Show which channels are configured for that contact
   • Explain channel capabilities and use cases
   • Indicate channel availability status

Examples

Natural language prompts that trigger this Skill:

• "Which channels can I use to reach Bob?"
• "What messaging channels are available?"
• "Show me available channels for contact abc123"
• "What channels does this app support?"
• "Can I send WhatsApp messages?"
• "What are my messaging options?"

MCP Tool Usage (Preferred if available):

1. Check if MCP Sinch server is configured (MCP server settings)
2. Use list-conversation-apps MCP tool to get apps and their channel configurations
3. MCP tools automatically use credentials from environment variables
4. If MCP is not available or tool execution fails, fallback to Conversation API

Conversation API Usage (Fallback):

1. Use the Conversation API endpoints for channel information (see endpoints above)
2. Authentication: Use Basic Auth with CONVERSATION_KEY_ID and CONVERSATION_KEY_SECRET, or OAuth2
3. Include required headers: Authorization, Content-Type: application/json
4. For capability query, note it's asynchronous - results are delivered via webhook callbacks with trigger CAPABILITY
5. App responses include channel configuration and credentials status
6. Contact responses include channel_identities array showing all associated channels

Supported Channels

• WHATSAPP: WhatsApp Business messages - rich media, templates, interactive messages
• SMS: SMS text messages - universal, simple text
• RCS: Rich Communication Services - rich media, read receipts, typing indicators
• MESSENGER: Facebook Messenger - rich media, quick replies
• VIBERBM: Viber Business Messages - rich media, carousels
• MMS: Multimedia Messaging Service - images, videos
• INSTAGRAM: Instagram Direct Messages - rich media, stories
• TELEGRAM: Telegram messages - rich media, bots
• KAKAOTALK: KakaoTalk messages - rich media, plus friends
• KAKAOTALKCHAT: KakaoTalk chat channel (ConsultationTalk)
• LINE: LINE messages - rich media, stickers
• WECHAT: WeChat messages - rich media, mini programs
• APPLEBC: Apple Messages for Business - rich media, Apple Pay

Channel Capabilities

Each channel supports different message types:

• Text messages: All channels
• Rich media: Images, videos, audio (channel-dependent)
• Templates: Pre-approved message templates (channel-dependent)
• Interactive messages: Buttons, quick replies (channel-dependent)
• Location sharing: Some channels
• File attachments: Channel-dependent

Notes

• Prefer MCP tools if MCP Sinch is configured - use list-conversation-apps for app and channel information
• Fallback to Conversation API if MCP is not configured or MCP tool execution fails
• Channel availability depends on app configuration and credentials
• Contacts can have multiple channels associated
• Some channels require specific setup and approval
• Capability query is asynchronous - use webhook callbacks to receive results
• Channel information is available in app responses and contact channel_identities