Latest
Strategic collaboration with REIL for advanced A2P Bulk SMS services. WhatsApp Business API is transforming customer communication worldwide. Chatbots: hyper-personalization and AI-powered customer support take centre stage. RCS brings rich, interactive messaging to every Android inbox.
Book a Demo →
Partner API

Build agents and campaigns with the Partner API.

Create an AI agent from a plain-language brief, point it at a contact list, launch a campaign and follow it live. A first monitored campaign takes about 30 minutes to set up.

What you can do

Everything you need to run outbound conversations.

Agents

Create voice agents from a plain-language brief, set their language and persona, and publish versions you can roll back.

Contacts and segments

Keep contact lists with per-contact details that fill the agent's variables, plus consent and do-not-disturb status.

Campaigns

Launch immediately or schedule within a calling window, with limits on concurrency and retries.

Live monitoring

See how many contacts are pending, being dialled or complete, and why a run paused or finished.

Transcripts and recordings

Read transcripts, listen to recordings and pull extracted fields from each conversation.

Knowledge for agents

Give an agent documents, web pages or text to draw on, and test what it can retrieve.

From key to campaign

Nine steps, start to finish.

This is the path a partner follows. The full guide with copy-paste examples is shared with partners.

  1. Get an API key

    An administrator creates a key in the console and picks its access level: full, standard or custom. The secret is shown once.

  2. Verify the key

    A first call confirms the key works and shows which workspace it belongs to.

  3. Create an agent

    Describe the job in plain language. AI-CON drafts the prompt, description and opening line, and can fill in a voice and language settings for you.

  4. Publish the agent

    A readiness check lists anything blocking publication. Only published versions run in campaigns.

  5. Add contacts and a segment

    Build a contact list, add people with the details the agent needs, and mark consent and do-not-disturb status.

  6. Create a campaign definition

    Combine an agent, a segment and default variables into a reusable set-up.

  7. Launch

    Start now or schedule inside a calling window, with limits on concurrent calls and retries.

  8. Monitor and control

    Follow progress live, then pause, resume or stop the run, or add more recipients while it runs.

  9. Receive webhooks

    Optionally have signed events pushed to your server instead of polling.

Built for reliable integrations

Safe to retry, easy to watch.

The API is designed so a network failure does not turn into duplicate calls.

  • Idempotency keys. Retry a request with the same key and you get the original response, not a second campaign run.
  • Consistent responses. Every response has the same shape, with a request ID you can quote to support.
  • Signed webhooks. Events carry a signature you verify before trusting them, and failed deliveries are retried.
  • Compliance built in. Contacts on do-not-disturb or with revoked consent are not dialled.
  • Limits you can plan for. Rate limits apply per key, and calls stop when workspace credits run out.
Diagram of API integration with data and message queues
FAQ

Developer questions.

Who is the Partner API for?

It is for developers and partners who want to create AI agents, manage contacts and run campaigns on AI-CON from their own software.

How do I get API access?

Keys are created by an administrator in the AI-CON console, under the Partner API settings. Each key has an access level, so a key can be limited to the actions it needs. Contact us to have access set up for your account.

Can I test without calling real customers?

Yes. You can launch a campaign against an empty list as a dry run, which checks your key, agent and set-up without placing a call. You can also place a single test call to your own phone.

Are contacts who opted out still called?

No. Contacts who are on a do-not-disturb list or whose consent has been revoked are not dialled.

Where can I get the full guide?

The step-by-step quickstart and the API reference are shared with partners. Contact us and we will send you the current version.

Ready to build on AI-CON?

Tell us about your use case and we will set up access and share the quickstart.