Skip to main content

How to Connect Infobip SMS to AI Agent

Connect your Flametree AI agent to Infobip SMS to enable automated conversations through SMS messaging. This integration allows your agent to send and receive SMS messages, making it accessible to customers via their mobile phones worldwide.

Prerequisites​

  • An active Infobip account with SMS capabilities
  • Infobip API credentials (API Key, Base URL, Sender ID)
  • A Flametree account with agent creation permissions
  • Admin access to the Flametree integration settings

Setting Up Infobip SMS Integration​

Step 1: Obtain Infobip Credentials​

  1. Log into Infobip Portal

  2. Get API Key

    • Go to Account → API Keys
    • Create a new API key or copy an existing one
    • Keep this secure — you'll need it for Flametree integration. Anyone with this key can send SMS messages using your account.

  3. Note Your Base URL

    • Find your base URL in the Infobip portal
    • Format: xxxxx.api.infobip.com (without https://)

  4. Configure Sender ID

    • Set up your sender ID in Infobip portal
    • This will appear as the sender name/number for SMS messages

Step 2: Configure Integration in Flametree​

  1. Navigate to Settings

    • Go to Settings > Channels.
    • Open Infobip.
    • Select Add +.

  2. Fill Configuration

    FieldDescriptionRequiredExample
    NameCustom name for this integration✅"SMS Support Channel"
    DescriptionOptional description for internal reference❌"Customer support via SMS"
    API KeyInfobip API key✅App 1234567890abcdef...
    API URLInfobip API URL✅xxxxx.api.infobip.com
    Sender nameArbitrary name to show✅YourBrand or +1234567890

    Field notes

    • Sender name: Can be alphanumeric or a phone number. Support depends on country and carrier.
    • API Key, API URL, Sender name: If SMS messages are not sent, verify these values in the Infobip portal and check your account balance.

  3. Click Save to create the integration

  4. Click Start in the upper-right corner to start the channel.

Step 3: Connect to AI Agent​

  1. Open Agent Configuration

    • Navigate to your target AI agent's settings
    • Go to Communication channels section

  2. Assign Channel

    • Select your Infobip SMS integration from the list
    • Save the agent configuration

  3. Restart the agent: click Stop agent then Start agent to apply the changes.

Configuration Options​

Customize Infobip behavior through Set Environment Variables:

VariableDescriptionDefault
INFOBIP_SHORT_DOMAINCustom short domain for URL trackinggo.flm3.com

SMS Capabilities and Handling​

The integration supports plain text SMS only — MMS, images, and other rich media are not supported. A few behaviors to keep in mind:

  • Length limit: messages longer than 1600 characters are automatically truncated with ..., so keep them short and clear.
  • Phone number format: numbers are normalized before sending — if the + prefix is missing, it is added automatically.
  • Delivery reports: forwarded to Flametree when they are enabled and configured on the Infobip side.
  • Cost control: monitor SMS usage and your account balance in the Infobip portal.

Testing the Integration​

  1. Send Test SMS

    • Have the agent send a message to your phone number
    • Verify you receive the SMS correctly
    • If the SMS is not sent, verify API credentials, sender name, and account balance in Infobip

  2. Reply via SMS

    • Reply to the received SMS
    • Check if the AI agent processes and responds to your message
    • If incoming SMS messages are not received, verify incoming message webhook configuration in Infobip

  3. Check Delivery Status

    • Monitor the logs for delivery reports
    • Verify messages are being delivered successfully
    • If delivery reports are missing, make sure delivery reports are enabled and configured in Infobip

When testing, ensure phone numbers are in international format:

✅ Correct❌ Incorrect
+1234567890, 1234567890 (+ will be added automatically)123-456-7890, (123) 456-7890

Security Considerations​

API Security​

  • Protect API Keys: Never expose API keys in client-side code or public repositories
  • Use HTTPS: All communications use HTTPS encryption
  • Rotate Credentials: Regularly rotate API keys for enhanced security
  • Monitor Usage: Track API usage for unusual patterns

Privacy Compliance​

  • Data Protection: Ensure SMS content complies with local privacy regulations (GDPR, CCPA, etc.)
  • Opt-out Mechanism: Implement clear opt-out procedures for recipients
  • Message Retention: Configure appropriate message retention policies
  • Consent Management: Obtain proper consent before sending marketing messages

Webhook Security​

  • IP Whitelisting: Restrict webhook access to Infobip IP ranges
  • Request Validation: Validate incoming webhook requests
  • Rate Limiting: Implement rate limiting on webhook endpoints
  • Error Handling: Secure error responses to prevent information disclosure

Was this article helpful?