# API and developers · Shimli

> Shimli REST API with an OpenAPI 3.1 specification: 18 endpoints for messaging, contacts, campaigns and catalog. Token authentication.

<!-- Fuente: https://www.shimliapp.com/en/developers · idioma: en -->

Developers

## The Shimli API: connect the agents to your systems.

A documented REST API with an OpenAPI 3.1 specification. Send messages, manage contacts, trigger campaigns and read operation state from your own systems.

Base URL **https://api.shimli.app**

Specification **OpenAPI 3.1.0**

Authentication **API token**

Endpoints **18**

[OpenAPI 3.1 specification The complete machine-readable API contract.](https://docs.shimli.app/api-reference/openapi.json) [Authentication How to get and use your API token.](https://docs.shimli.app/getting-started/authentication) [Quickstart From a new account to your first message sent.](https://docs.shimli.app/getting-started/quickstart) [Full documentation Platform guides, Flow Builder and API reference.](https://docs.shimli.app) [Index for language models The same content in a single text file.](https://docs.shimli.app/llms.txt)

### What the API exposes

The 18 endpoints grouped by what they solve. The detail of each one, with parameters and examples, lives in the reference.

#### Messaging

Send and read messages over WhatsApp, WhatsApp Business API, Facebook Messenger, SMS and live chat.

- POST /v1/msg-wh
- GET /v1/msg-wh/{ID_MESSAGE}
- POST /v1/whatsapp-api
- POST /v1/facebook/send-messenger
- POST /v1/sms
- POST /v1/live-chat
- POST /v1/live-chat/session
- POST /v1/valid-whatsapp

#### Contacts and CRM

Create and read contacts, and push leads straight into the CRM.

- GET /v1/contact
- POST /v1/contact
- POST /v1/crm

#### Campaigns

List bulk campaigns and read their detail and delivery metrics.

- GET /v1/campaigns
- GET /v1/campaigns/ID_CAMPAIGN
- GET /v1/campaigns/ID_CAMPAIGN/details

#### Agents and account

Manage the account's human seats and read client data.

- GET /v1/agent
- POST /v1/agent
- DELETE /v1/agent
- GET /v1/client

#### Catalog and links

Product catalog for conversational commerce, and short links with tracking.

- POST /v1/shop/products
- GET /v1/shop/products/ID_PRODUCT
- PUT /v1/shop/products/ID_PRODUCT
- DELETE /v1/shop/products/ID_PRODUCT
- POST /v1/short
- PATCH /v1/short

### Authentication

Every call carries the account's API token. It is generated from the Shimli panel and does not expire on its own: it is revoked when needed.

curl -X POST "https://api.shimli.app/v1/msg-wh?token=TU_TOKEN" \
-H "Content-Type: application/json" \
-d '{ "phone": "50499998888", "message": "Hola" }' The full guide, with errors and limits, lives in [docs.shimli.app](https://docs.shimli.app/getting-started/authentication) .

### For AI agents

If you are building an agent that needs to operate on a Shimli account, these are the files you can read without browsing the site.

[/llms.txt Site index and when to use Shimli](https://www.shimliapp.com/llms.txt) [/llms-full.txt Extended product context](https://www.shimliapp.com/llms-full.txt) [/pricing.md Pricing in markdown](https://www.shimliapp.com/pricing.md) [/feed/schema.jsonl Structured data for all 26 pages](https://www.shimliapp.com/feed/schema.jsonl)

Every page also answers in markdown: append .md to any URL, like [/en/precios .md](https://www.shimliapp.com/en/precios.md) .

Frequently asked

### What people ask before getting started.

Straight answers on what Shimli is, what it costs, what it integrates with and who is behind it.

What is Shimli? – Shimli is a platform to build and run AI agents at financial institutions. An AI agent is a program that understands the context of a conversation, queries the institution’s systems, decides within the policies defined for it and carries the task through to the end. It is built by Sheilim LLC, headquartered in Miami.

What is the difference between a chatbot and an AI agent? + A chatbot replies from a script: it recognizes an intent and returns text written in advance. An AI agent understands context, analyzes information, executes tasks in the institution’s systems and escalates to a person when needed. A chatbot replies; an agent resolves.

How much does Shimli cost? + One plan at $139 a month with every feature on the platform: there are no editions or tiers. It includes 3 human seats and 1 admin, 1 Flow Builder, WhatsApp, Facebook, Instagram and web connection, and unlimited WhatsApp templates. Added separately: an extra instance at $59 a month, an extra Flow Builder at $19, an extra human seat at $9, and AI usage at $49 per 2,450 queries. The trial runs 14 days.

The next step

### Let's spend 30 minutes designing your first agent.

We identify a concrete use case, collections, payment reminders or credit analysis, and show you how to apply it to your operation, measuring results from the first weeks.

Book a discovery session

From $139 a month, with a 14-day trial and self-serve setup. [See pricing](https://www.shimliapp.com/en/precios)

01 **Discovery** Use case, volume and KPIs to improve

02 **Pilot** Controlled agent on a real process

03 **Scale** Progressive connection via API
