CTRLK
CTRLK
Try for free
View All Tutorials
SMS
Viber
Infobip MCP

Send a multichannel campaign using an Infobip MCP server and OpenAI Agents SDK

|

View as Markdown

This tutorial explains how to send a multichannel campaign using Infobip MCP servers and the OpenAI Agents SDK.

As an outcome, you'll build a system that can automatically route requests to the appropriate messaging channel, Viber or SMS, craft message content based on provided criteria, handle multiple recipients simultaneously, and provide feedback on message delivery status.

You can adapt code samples to add more channels or use other channels available through the Infobip MCP.

Products and channels [#products-channels]

  • SMS
  • Viber

Prerequisites [#prerequisites]

  • Python 3.9 or later

  • OpenAI Agents SDK.

    pip install example
    pip install openai-agents

  • OPENAI_API_KEY environment variable set with your OpenAI API key. You can find it in your OpenAI account settings.

    bash
    export OPENAI_API_KEY=your_openai_api_key

    If you are using the OpenAI Agents SDK, you can also set the OPENAI_API_KEY in your code:

    Python
    1 import os
    2 os.environ["OPENAI_API_KEY"] = "your_openai_api_key"

  • Infobip account. If you do not have one, sign up for a free account. For more information, see Create an account.

  • Infobip API key with the following scopes:

    • sms:message:send
    • viber-bm:message:send

    Find out more about API keys and scopes.

  • Sender: If your account is in free trial, use the following test senders:

    • SMS: InfoSMS
    • Viber: IBSelfServe

    If you want to configure a custom sender, request a new number or an alphanumeric sender through your Infobip account or use the Infobip Numbers API.

  • Destination: A phone number to which the message will be sent.

    If your account is in the free trial, you can only send messages to a verified phone number.

Technical specifications [#technical-specifications]

The system consists of the following:

  • Specialist AI agents to send SMS and Viber messages
  • An orchestrator agent that coordinates the specialist AI agents
  • OpenAI Agents SDK to create these AI agents
  • The following MCP servers that the specialist AI agents use to send messages:
    • An Infobip SMS MCP server for SMS messages
    • An Infobip Viber MCP server for Viber messages
  • An AI client that calls the orchestrator

Process overview [#process-overview]

  1. Create the following MCP server configurations for the specialist AI agents.

    • Infobip SMS MCP server configuration
    • Infobip Viber MCP server configuration

  2. Create the following specialist AI agents:

    • For SMS
    • For Viber

  3. Create an orchestrator AI agent that uses the SMS and Viber AI agents.

  4. In your AI client, call the orchestrator to send messages to multiple users through SMS and Viber.

Implementation steps [#implementation-steps]

Complete the steps in each of the following sections sequentially.

Create the Infobip MCP server configurations for your AI agents [#create-mcp-server]

Use the MCP Server Streamable HTTP client to create the following MCP servers that the specialist AI agents can use to send messages:

  • An Infobip SMS MCP server for SMS messages
  • An Infobip Viber MCP server for Viber messages
Python
1import os
2 
3from agents.mcp import MCPServerStreamableHttp, MCPServerStreamableHttpParams
4 
5IB_API_KEY = os.getenv("IB_API_KEY")
6 
7sms_mcp_server = MCPServerStreamableHttp(
8 params=MCPServerStreamableHttpParams(
9 url="https://mcp.infobip.com/sms",
10 headers={"Authorization": f"App {IB_API_KEY}"},
11 ),
12 client_session_timeout_seconds=30,
13)
14 
15viber_mcp_server = MCPServerStreamableHttp(
16 params=MCPServerStreamableHttpParams(
17 url="https://mcp.infobip.com/viber",
18 headers={"Authorization": f"App {IB_API_KEY}"},
19 ),
20 client_session_timeout_seconds=30,
21)

Create specialist AI agents for SMS and Viber channels [#create-specialist-agents]

Use the OpenAI Agents SDK to create AI agents that send SMS and Viber messages using the Infobip MCP servers that you created.

Python
1from agents import Agent, ModelSettings
2 
3MODEL_NAME = os.getenv("MODEL_NAME")
4 
5sms_agent = Agent(
6 name="Infobip SMS MCP Agent",
7 handoff_description="Specialist agent for Infobip SMS MCP questions",
8 instructions="Send SMS messages, read delivery reports and logs, and manage campaigns using the Infobip SMS MCP API.",
9 mcp_servers=[sms_mcp_server],
10 model_settings=ModelSettings(tool_choice="required", store=True),
11 model=MODEL_NAME,
12)
13 
14viber_agent = Agent(
15 name="Infobip Viber MCP Agent",
16 handoff_description="Specialist agent for Infobip Viber MCP questions",
17 instructions="Send Viber messages, read delivery reports and logs, and manage campaigns using the Infobip Viber MCP API.",
18 mcp_servers=[viber_mcp_server],
19 model_settings=ModelSettings(tool_choice="required", store=True),
20 model=MODEL_NAME,
21)

Create an orchestrator AI agent that uses the SMS and Viber AI agents [#create-orchestrator]

Use the OpenAI Agents SDK to create an orchestrator agent that decides which specialist AI agent to use. Depending on the end user's request, the orchestrator routes the request to the relevant agent (SMS or Viber).

Python
1orchestrator_agent = Agent(
2 name="Orchestrator Agent",
3 instructions="You are an orchestrator agent that decides which specialist agent to use based on the user's request.",
4 handoffs=[sms_agent, viber_agent],
5 model=MODEL_NAME,
6)

Use the orchestrator in your AI client to send messages [#use-orchestrator-in-ai-client]

In your AI client, write a prompt to do the following:

  • Send an SMS and Viber message campaign.
  • Call the orchestrator agent.

Guidelines for the prompt

  • Specify the sender and destinations.

  • Describe your use case so that the AI can create a relevant message.

  • Include the following information so that the AI does not guess or invent missing information.

    • Limitations. Example: Only one message, specific delivery window
    • Personalized details. Example: Specific URL, image

Create the prompt

Python
1import asyncio
2 
3from agents import Runner
4 
5def create_campaign_prompt(channel: str, sender: str, destinations: list[str], message: str) -> str:
6 return f"""
7 Send a bulk black Friday promotional message to the following phone numbers: {", ".join(destinations)}.
8 Send the messages under the sender {sender}.
9
10 The message should be sent via {channel} channel.
11
12 The company offering the promotion is Infobip. Use the following message: {message}.
13
14 After sending the messages, check if they were sent successfully and provide a summary of the results.
15 """
16 
17async def main():
18 destinations = ["441134960001, 441134960002, 441134960003"]
19 promotion_message = "BLACK FRIDAY: 70% OFF! Code: BF70. Shop now, ends midnight!"
20 
21 async with sms_mcp_server, viber_mcp_server:
22 result = await Runner.run(
23 orchestrator_agent,
24 create_campaign_prompt("SMS", "ServiceSMS", destinations, promotion_message),
25 )
26 print("SMS: ", result.final_output)
27
28 result = await Runner.run(
29 orchestrator_agent,
30 create_campaign_prompt("Viber", "DemoCompany", destinations, promotion_message),
31 )
32 print("Viber: ", result.final_output)
33 
34 
35if __name__ == "__main__":
36 asyncio.run(main())

Reports [#reports]

After the AI sends the message, it returns a summary of what it did, and retrieves a delivery report when it is available.

The following is an example of the summary for SMS messages:

json
1SMS: ### Bulk Black Friday Promotion Summary
2 
3**Messages Sent:**
4Each message contained the text:
5> BLACK FRIDAY: 70% OFF! Code: BF70. Shop now - ends midnight!
6It was sent from sender ID **ServiceSMS** to the following recipients:
71. **+441134960001**
82. **+441134960002**
93. **+441134960003**
10 
11---
12 
13### Delivery Results:
14 
15**1. Recipient:** +441134960001
16- **Status:** PENDING
17- The message is en route to the recipient's device.
18 
19**2. Recipient:** +441134960002
20- **Status:** DELIVERED TO HANDSET
21- The message was successfully delivered to the recipient's device.
22 
23**3. Recipient:** +441134960003
24- **Status:** DELIVERED TO HANDSET
25- The message was successfully delivered to the recipient's device.
26 
27---
28 
29**Notes:**
30- Two messages were successfully delivered, while the status for one is still pending.

The following is an example of the summary for Viber messages:

json
1Viber: ### Summary of Actions:
21. **Message Sent**: Promotional messages about Black Friday were sent to three recipients:
3 - **+441134960001**
4 - **+441134960002**
5 - **+441134960003**
6 - Sender: **DemoCompany**
7 
8### Delivery Summary:
9 
10- The sending was successful, but messages are currently in the **PENDING** state across the recipients. This means:
11 - The message was accepted and sent to the next instance for delivery.
12 - Delivery has not yet been completed nor failed.
13 
14### Status Breakdown:
15- **Destination: +441134960001**:
16 - Status: **PENDING_ACCEPTED**
17 - Description: Message sent to the next instance.
18 
19- **Destination: +441134960002**:
20 - Status: **PENDING_ACCEPTED**
21 - Description: Message sent to the next instance.
22 
23- **Destination: +441134960003**:
24 - Status: **PENDING_ACCEPTED**
25 - Description: Message sent to the next instance.
26 
27### Next Steps:
28Delivery reports will update when the recipient's device or network confirms receipt.

Additional resources [#additional-resources]

Need assistance

Explore Infobip Tutorials

Encountering issues

Contact our support

What's new? Check out

Release Notes

Unsure about a term? See

Glossary
Service status

Copyright @ 2006-2026 Infobip ltd.

Service Terms & ConditionsPrivacy policyTerms of use