# Delete Agent
Source: https://docs.shimli.app/api-reference/agents/delete-agent
Endpoint DELETE /v1/agent
`DELETE` `/v1/agent`
## Autenticacion
Este endpoint requiere tu token de API. Incluyelo en el body como `token` o como query param `token`/`api-token`. Ve [Autenticacion](/getting-started/authentication) para mas detalles.
## Ejemplo de request
```bash theme={null}
curl -X DELETE https://api.shimli.app/v1/agent \
-H "Content-Type: application/json" \
-d '{
"token": "TOKEN_SHIMLI",
"id": "ID_AGENT"
}'
```
## Respuesta
```json title="200 OK" theme={null}
{
"statusCode": 200,
"body": {
"err": false
}
}
```
# Get Agent
Source: https://docs.shimli.app/api-reference/agents/get-agent
Endpoint GET /v1/agent
`GET` `/v1/agent`
## Autenticacion
Este endpoint requiere tu token de API. Incluyelo en el body como `token` o como query param `token`/`api-token`. Ve [Autenticacion](/getting-started/authentication) para mas detalles.
## Ejemplo de request
```bash theme={null}
curl -X GET "https://api.shimli.app/v1/agent?id=ID_AGENT&token=TOKEN_SHIMLI" \
-H "Content-Type: application/json"
```
## Respuesta
```json title="200 OK" theme={null}
{
"statusCode": 200,
"body": {
"err": false
}
}
```
# Insert Agent
Source: https://docs.shimli.app/api-reference/agents/insert-agent
Endpoint POST /v1/agent
`POST` `/v1/agent`
## Body
```json theme={null}
{
"token": "TOKEN_SHIMLI",
"name": "Name_Agent",
"phone": "Number_Agent",
"email": "Email_Agent"
}
```
## Autenticacion
Este endpoint requiere tu token de API. Incluyelo en el body como `token` o como query param `token`/`api-token`. Ve [Autenticacion](/getting-started/authentication) para mas detalles.
## Ejemplo de request
```bash theme={null}
curl -X POST https://api.shimli.app/v1/agent \
-H "Content-Type: application/json" \
-d '{
"token": "TOKEN_SHIMLI",
"name": "Name_Agent",
"phone": "Number_Agent",
"email": "Email_Agent"
}'
```
## Respuesta
```json title="200 OK" theme={null}
{
"statusCode": 200,
"body": {
"err": false
}
}
```
# Get Details of Campaign
Source: https://docs.shimli.app/api-reference/campaigns/campaign-details
Endpoint GET /v1/campaigns/ID_CAMPAIGN/details
`GET` `/v1/campaigns/ID_CAMPAIGN/details`
## Autenticacion
Este endpoint requiere tu token de API. Incluyelo en el body como `token` o como query param `token`/`api-token`. Ve [Autenticacion](/getting-started/authentication) para mas detalles.
## Ejemplo de request
```bash theme={null}
curl -X GET "https://api.shimli.app/v1/campaigns/ID_CAMPAIGN/details" \
-H "Content-Type: application/json"
```
## Respuesta
```json title="200 OK" theme={null}
{
"statusCode": 200,
"body": {
"err": false
}
}
```
# Get Campaign
Source: https://docs.shimli.app/api-reference/campaigns/get-campaign
Endpoint GET /v1/campaigns/ID_CAMPAIGN
`GET` `/v1/campaigns/ID_CAMPAIGN`
## Autenticacion
Este endpoint requiere tu token de API. Incluyelo en el body como `token` o como query param `token`/`api-token`. Ve [Autenticacion](/getting-started/authentication) para mas detalles.
## Ejemplo de request
```bash theme={null}
curl -X GET "https://api.shimli.app/v1/campaigns/ID_CAMPAIGN" \
-H "Content-Type: application/json"
```
## Respuesta
```json title="200 OK" theme={null}
{
"statusCode": 200,
"body": {
"err": false
}
}
```
# Campaigns
Source: https://docs.shimli.app/api-reference/campaigns/list-campaigns
Endpoint GET /v1/campaigns
`GET` `/v1/campaigns`
## Autenticacion
Este endpoint requiere tu token de API. Incluyelo en el body como `token` o como query param `token`/`api-token`. Ve [Autenticacion](/getting-started/authentication) para mas detalles.
## Ejemplo de request
```bash theme={null}
curl -X GET "https://api.shimli.app/v1/campaigns?page=1&limit=10" \
-H "Content-Type: application/json"
```
## Respuesta
```json title="200 OK" theme={null}
{
"statusCode": 200,
"body": {
"err": false
}
}
```
# Get Contact
Source: https://docs.shimli.app/api-reference/contacts/get-contact
# Get a contact
# Get a contact
`GET` `/v1/contact`
## Autenticacion
Este endpoint requiere tu token de API. Incluyelo en el body como `token` o como query param `token`/`api-token`. Ve [Autenticacion](/getting-started/authentication) para mas detalles.
## Ejemplo de request
```bash theme={null}
curl -X GET "https://api.shimli.app/v1/contact?id=ID_LIST&token=TOKEN_SHIMLI" \
-H "Content-Type: application/json"
```
## Respuesta
```json title="200 OK" theme={null}
{
"statusCode": 200,
"body": {
"err": false
}
}
```
# Insert Contact
Source: https://docs.shimli.app/api-reference/contacts/insert-contact
# Adding a contact to a specific list
# Adding a contact to a specific list
\**Important: ID\_WHATSAPP must contain the following structure "COUNTY\_CODE" + "PHONE\_NUMBER" example 14243962506*
In the value object, you need to send all the fields you want to enter the list
`POST` `/v1/contact`
## Body
```json theme={null}
{
"token": "TOKEN_SHIMLI",
"idList": "ID_LIST",
"values": {
"phone": "ID_WHATSAPP",
"name": "NAME"
}
}
```
## Autenticacion
Este endpoint requiere tu token de API. Incluyelo en el body como `token` o como query param `token`/`api-token`. Ve [Autenticacion](/getting-started/authentication) para mas detalles.
## Ejemplo de request
```bash theme={null}
curl -X POST https://api.shimli.app/v1/contact \
-H "Content-Type: application/json" \
-d '{
"token": "TOKEN_SHIMLI",
"idList": "ID_LIST",
"values": {
"phone": "ID_WHATSAPP",
"name": "NAME"
}
}'
```
## Respuesta
```json title="200 OK" theme={null}
{
"statusCode": 200,
"body": {
"err": false
}
}
```
# Create Live Chat session
Source: https://docs.shimli.app/api-reference/live-chat/create-session
Optional parameters
Optional parameters
* name string = name of contact
`POST` `/v1/live-chat/session`
## Body
```json theme={null}
{
"token": "{{token}}",
"instance": "{{instance}}"
}
```
## Autenticacion
Este endpoint requiere tu token de API. Incluyelo en el body como `token` o como query param `token`/`api-token`. Ve [Autenticacion](/getting-started/authentication) para mas detalles.
## Ejemplo de request
```bash theme={null}
curl -X POST https://api.shimli.app/v1/live-chat/session \
-H "Content-Type: application/json" \
-d '{
"token": "{{token}}",
"instance": "{{instance}}"
}'
```
## Respuesta
```json title="200 OK" theme={null}
{
"statusCode": 200,
"body": {
"err": false
}
}
```
# Send Live Chat Message
Source: https://docs.shimli.app/api-reference/live-chat/send-message
Optional parameters
Optional parameters
* user boolean = true send by user, for defaul is false
`POST` `/v1/live-chat`
## Body
```json theme={null}
{
"token": "{{token}}",
"type": "text",
"body": "Hi 👋!!",
"to": "{{session}}",
"instance": "{{instance}}"
}
```
## Autenticacion
Este endpoint requiere tu token de API. Incluyelo en el body como `token` o como query param `token`/`api-token`. Ve [Autenticacion](/getting-started/authentication) para mas detalles.
## Ejemplo de request
```bash theme={null}
curl -X POST https://api.shimli.app/v1/live-chat \
-H "Content-Type: application/json" \
-d '{
"token": "{{token}}",
"type": "text",
"body": "Hi 👋!!",
"to": "{{session}}",
"instance": "{{instance}}"
}'
```
## Respuesta
```json title="200 OK" theme={null}
{
"statusCode": 200,
"body": {
"err": false
}
}
```
# Send Facebook Messenger
Source: https://docs.shimli.app/api-reference/messaging/facebook-messenger
TYPE_MESSAGE = ['text', 'image', 'video', 'file', 'audio']
*TYPE\_MESSAGE = \["text", "image", "video", "file", "audio"]*
\**Important: When sending a multimedia message (image, video, gif, audio, document) the body parameter must contain the URL of the file)*
Optional parameters
* caption *string* = Text when sending an image or video message
`POST` `/v1/facebook/send-messenger`
## Body
```json theme={null}
{
"token": "TOKEN_SHIMLI",
"type": "TYPE_MESSAGE",
"body": "Hi 👋!!",
"to": "PSID_MESSENGER",
"instance": "ID_INSTANCE"
}
```
## Autenticacion
Este endpoint requiere tu token de API. Incluyelo en el body como `token` o como query param `token`/`api-token`. Ve [Autenticacion](/getting-started/authentication) para mas detalles.
## Ejemplo de request
```bash theme={null}
curl -X POST https://api.shimli.app/v1/facebook/send-messenger \
-H "Content-Type: application/json" \
-d '{
"token": "TOKEN_SHIMLI",
"type": "TYPE_MESSAGE",
"body": "Hi 👋!!",
"to": "PSID_MESSENGER",
"instance": "ID_INSTANCE"
}'
```
## Respuesta
```json title="200 OK" theme={null}
{
"statusCode": 200,
"body": {
"err": false
}
}
```
# Enviar tu primer mensaje vía API
Source: https://docs.shimli.app/api-reference/messaging/first-message
Ejemplos para enviar mensajes de WhatsApp, Facebook Messenger y SMS desde una integración con la API de Shimli.
Esta guía es para desarrolladores que integran Shimli con un sistema propio. Si solo quieres enviar mensajes desde la plataforma, sigue la guía de [tu primer mensaje desde Inbox](/getting-started/first-message).
## Antes de empezar
* Ten un [token de API](/getting-started/authentication).
* Conecta el canal correspondiente y obtén su identificador de instancia.
* Para WhatsApp y SMS, usa el número del destinatario con código de país.
## WhatsApp Business
Envía un mensaje de texto con `POST /v1/whatsapp-api`:
```bash theme={null}
curl -X POST https://api.shimli.app/v1/whatsapp-api \\
-H "Content-Type: application/json" \\
-d '{
"token": "TOKEN_SHIMLI",
"type": "text",
"body": "¡Hola! Bienvenido a nuestra tienda.",
"to": "50499999999",
"instance": "ID_INSTANCE"
}'
```
Para enviar una plantilla aprobada o contenido multimedia, consulta la [referencia de WhatsApp Business API](/api-reference/messaging/whatsapp-business-api).
## Facebook Messenger
Envía un mensaje de texto con `POST /v1/facebook/send-messenger`. El campo `to` es el PSID de la persona, no su número de teléfono:
```bash theme={null}
curl -X POST https://api.shimli.app/v1/facebook/send-messenger \\
-H "Content-Type: application/json" \\
-d '{
"token": "TOKEN_SHIMLI",
"type": "text",
"body": "¡Hola! ¿En qué te puedo ayudar?",
"to": "PSID_MESSENGER",
"instance": "ID_INSTANCE"
}'
```
Consulta la [referencia de Facebook Messenger](/api-reference/messaging/facebook-messenger) para los tipos de mensaje disponibles.
## SMS
Envía un SMS con `POST /v1/sms`:
```bash theme={null}
curl -X POST https://api.shimli.app/v1/sms \\
-H "Content-Type: application/json" \\
-d '{
"token": "TOKEN_SHIMLI",
"type": "text",
"body": "Tu código de verificación es 8294.",
"to": "50499999999",
"instance": "ID_INSTANCE"
}'
```
Consulta la [referencia de SMS](/api-reference/messaging/sms) para más detalles.
## Respuesta
Los endpoints responden con un objeto que indica si la solicitud fue aceptada y, según el canal, incluye el identificador del mensaje. Consulta la referencia del canal para ver el formato de respuesta específico.
Los ejemplos usan valores ilustrativos. Sustituye el token, la instancia y el destinatario por datos válidos de tu cuenta; protege tu token y no lo expongas en el frontend de una aplicación.
# Get Client
Source: https://docs.shimli.app/api-reference/messaging/get-client
Endpoint GET /v1/client
`GET` `/v1/client`
## Autenticacion
Este endpoint requiere tu token de API. Incluyelo en el body como `token` o como query param `token`/`api-token`. Ve [Autenticacion](/getting-started/authentication) para mas detalles.
## Ejemplo de request
```bash theme={null}
curl -X GET "https://api.shimli.app/v1/client" \
-H "Content-Type: application/json"
```
## Respuesta
```json title="200 OK" theme={null}
{
"statusCode": 200,
"body": {
"err": false
}
}
```
# Lead to CRM
Source: https://docs.shimli.app/api-reference/messaging/lead-to-crm
# Lead injection in CRM
# Lead injection in CRM
\**Important: ID\_WHATSAPP must contain the following structure "COUNTY\_CODE" + "PHONE\_NUMBER" + "@c.us" example [14243962506@c.us](mailto:14243962506@c.us)*
Optional parameters
* area *string* = Area or equipment code
* agent *string* = Agent ID, for this to be possible you must send an area to which the agent belongs
* process *string* = Process ID
* tags *string* = example \["customer service", "sales"]
* channel *string* = whatsapp or fb-messenger
`POST` `/v1/crm`
## Body
```json theme={null}
{
"to": "ID_CONTACT",
"instance": "ID_INSTANCE",
"text": "Open from API",
"token": "TOKEN_SHIMLI",
"area": "ID_AREA",
"channel": "ID_CHANNEL"
}
```
## Autenticacion
Este endpoint requiere tu token de API. Incluyelo en el body como `token` o como query param `token`/`api-token`. Ve [Autenticacion](/getting-started/authentication) para mas detalles.
## Ejemplo de request
```bash theme={null}
curl -X POST https://api.shimli.app/v1/crm \
-H "Content-Type: application/json" \
-d '{
"to": "ID_CONTACT",
"instance": "ID_INSTANCE",
"text": "Open from API",
"token": "TOKEN_SHIMLI",
"area": "ID_AREA",
"channel": "ID_CHANNEL"
}'
```
## Respuesta
```json title="200 OK" theme={null}
{
"statusCode": 200,
"body": {
"err": false
}
}
```
# Send Email
Source: https://docs.shimli.app/api-reference/messaging/send-email
Endpoint POST /v1/email/send para envío transaccional de correo
`POST` `/v1/email/send`
Envía **un solo correo transaccional** usando una plantilla guardada y un remitente verificado de la cuenta.
## Body
```json theme={null}
{
"token": "{{token}}",
"sender": "snd_1a2b3c",
"to": "cliente@empresa.com",
"subject": "Confirmación de pedido",
"templateId": "tpl_4d5e6f",
"params": {
"nombre": "María",
"pedido": "A1024"
},
"reference": "orden-A1024"
}
```
También puedes pasar el remitente como objeto con `email` y `name`, siempre que esté registrado como sender en Shimli:
```json theme={null}
{
"token": "{{token}}",
"sender": {
"email": "no-reply@empresa.com",
"name": "Empresa"
},
"to": "cliente@empresa.com",
"subject": "Confirmación de pedido",
"templateId": "tpl_4d5e6f",
"params": {
"nombre": "María",
"pedido": "A1024"
},
"reference": "orden-A1024"
}
```
## Parámetros
| Campo | Requerido | Qué hace |
| - | -: | - |
| `token` | Sí | Token de autenticación |
| `sender` | Sí | ID del sender registrado en Shimli, u objeto con `email` y `name` de un sender registrado |
| `to` | Sí | Destinatario |
| `subject` | No | Asunto del correo; puede sobrescribir el de la plantilla |
| `templateId` | Sí | ID de la plantilla guardada de email |
| `params` | No | Variables para reemplazar dentro de la plantilla |
| `reference` | No | Referencia para idempotencia |
## Autenticación
Este endpoint requiere tu token de API. Inclúyelo en el body como `token` o como query param `token` / `api-token`. Ve [Autenticación](/getting-started/authentication) para más detalles.
## Ejemplo de request
```bash theme={null}
curl -X POST https://api.shimli.app/v1/email/send \
-H "Content-Type: application/json" \
-d '{
"token": "{{token}}",
"sender": "snd_1a2b3c",
"to": "cliente@empresa.com",
"subject": "Confirmación de pedido",
"templateId": "tpl_4d5e6f",
"params": {
"nombre": "María",
"pedido": "A1024"
},
"reference": "orden-A1024"
}'
```
## Respuesta
```json title="200 OK" theme={null}
{
"statusCode": 200,
"body": {
"err": false,
"msgId": "email_12345"
}
}
```
# Send SMS
Source: https://docs.shimli.app/api-reference/messaging/sms
Endpoint POST /v1/sms
`POST` `/v1/sms`
## Body
```json theme={null}
{
"token": "{{token}}",
"type": "text",
"body": "Hi 👋!!",
"to": "PHONE_NUMBER",
"instance": "{{instance}}"
}
```
## Autenticacion
Este endpoint requiere tu token de API. Incluyelo en el body como `token` o como query param `token`/`api-token`. Ve [Autenticacion](/getting-started/authentication) para mas detalles.
## Ejemplo de request
```bash theme={null}
curl -X POST https://api.shimli.app/v1/sms \
-H "Content-Type: application/json" \
-d '{
"token": "{{token}}",
"type": "text",
"body": "Hi 👋!!",
"to": "PHONE_NUMBER",
"instance": "{{instance}}"
}'
```
## Respuesta
```json title="200 OK" theme={null}
{
"statusCode": 200,
"body": {
"err": false
}
}
```
# Valid WhatsApp Number
Source: https://docs.shimli.app/api-reference/messaging/valid-whatsapp
Method that verifies if a number has WhatsApp active
Method that verifies if a number has WhatsApp active
`POST` `/v1/valid-whatsapp`
## Body
```json theme={null}
{
"token": "TOKEN_SHIMLI",
"instance": "INSTANCE_SHIMLI",
"number": "NUMBER_WHATSAPP"
}
```
## Autenticacion
Este endpoint requiere tu token de API. Incluyelo en el body como `token` o como query param `token`/`api-token`. Ve [Autenticacion](/getting-started/authentication) para mas detalles.
## Ejemplo de request
```bash theme={null}
curl -X POST https://api.shimli.app/v1/valid-whatsapp \
-H "Content-Type: application/json" \
-d '{
"token": "TOKEN_SHIMLI",
"instance": "INSTANCE_SHIMLI",
"number": "NUMBER_WHATSAPP"
}'
```
## Respuesta
```json title="200 OK" theme={null}
{
"statusCode": 200,
"body": {
"err": false,
"response": {
"id": "1234567890@c.us",
"status": 404,
"isBusiness": false,
"canReceiveMessage": false
}
}
}
```
# Send WhatsApp Business API
Source: https://docs.shimli.app/api-reference/messaging/whatsapp-business-api
TYPE_MESSAGE = ['text', 'image', 'video', 'document', 'audio', 'template']
*TYPE\_MESSAGE = \["text", "image", "video", "document", "audio", "template"]*
**Important:**
* Al enviar mensajes multimedia (`image`, `video`, `audio`, `document`), el parámetro `body` debe contener la URL pública del archivo.
* Al enviar plantillas preaprobadas (`template`), debes especificar el objeto `template` con su nombre, idioma y los componentes de variables o botones (especialmente para plantillas de **Authentication / OTP**).
Optional parameters
* `caption` *string* = Texto explicativo al enviar imágenes o videos.
* `template` *object* = Configuración y parámetros de la plantilla (requerido cuando `type = "template"`).
`POST` `/v1/whatsapp-api`
## Body (Mensaje estándar)
```json theme={null}
{
"token": "{{token}}",
"type": "text",
"body": "Hi 👋!!",
"to": "NUMBER_WHATSAPP",
"instance": "{{instance}}"
}
```
## Body (Envío de plantilla de Autenticación / OTP)
Para despachar una plantilla de la categoría **Authentication** con botones de **copiar código (`copy_code`)** o **autocompletar (`one_tap` / `zero_tap`)**, se envía el código OTP en los parámetros del cuerpo y del botón.
```json theme={null}
{
"token": "{{token}}",
"type": "template",
"to": "50499999999",
"instance": "{{instance}}",
"template": {
"name": "verificacion_portal_v2",
"language": {
"code": "es_MX"
},
"components": [
{
"type": "body",
"parameters": [
{
"type": "text",
"text": "849201"
}
]
},
{
"type": "button",
"sub_type": "url",
"index": 0,
"parameters": [
{
"type": "text",
"text": "849201"
}
]
}
]
}
}
```
**Inyección automática de variable OTP**: En plantillas de autenticación, la variable `{{1}}` inyecta el código de verificación de 4 a 8 dígitos tanto en el texto predeterminado del cuerpo como en el botón OTP dinámico (`sub_type: "url"`, `index: 0`).
### Métodos de entrega admitidos en plantillas OTP
El comportamiento del botón en el dispositivo del destinatario depende de cómo se haya registrado la plantilla en Meta:
| Método | Configuración de plantilla | Comportamiento en WhatsApp |
| - | - | - |
| `copy_code` | Sin requisitos adicionales de app | Botón interactivo para copiar el código al portapapeles. |
| `one_tap` | Requiere `package_name` y `app_signature_hash` (11 caracteres) | Al pulsar el botón, WhatsApp envía el código a tu app Android. Se degrada a `copy_code` si el dispositivo no es compatible. |
| `zero_tap` | Requiere `package_name`, `app_signature_hash` y aceptación de términos | WhatsApp entrega el código a tu app en segundo plano sin pulsar botones. Se degrada a `one_tap` o `copy_code` en caso de incompatibilidad. |
## Autenticacion
Este endpoint requiere tu token de API. Incluyelo en el body como `token` o como query param `token`/`api-token`. Ve [Autenticacion](/getting-started/authentication) para mas detalles.
## Ejemplo de request
```bash theme={null}
curl -X POST https://api.shimli.app/v1/whatsapp-api \
-H "Content-Type: application/json" \
-d '{
"token": "{{token}}",
"type": "template",
"to": "50499999999",
"instance": "{{instance}}",
"template": {
"name": "verificacion_portal_v2",
"language": {
"code": "es_MX"
},
"components": [
{
"type": "body",
"parameters": [{ "type": "text", "text": "849201" }]
},
{
"type": "button",
"sub_type": "url",
"index": 0,
"parameters": [{ "type": "text", "text": "849201" }]
}
]
}
}'
```
## Respuesta
```json theme={null}
{
"success": true,
"messageId": "wamid.HBgLM...",
"status": "sent"
}
```
# Create Product
Source: https://docs.shimli.app/api-reference/shop/create-product
Endpoint POST /v1/shop/products
`POST` `/v1/shop/products`
## Body
```json theme={null}
{
"name": "NAME PRODUCT",
"description": "DESCRIPTION_PRODUCT",
"descriptionai": "",
"code": "",
"price": 23.98,
"category": []
}
```
## Autenticacion
Este endpoint requiere tu token de API. Incluyelo en el body como `token` o como query param `token`/`api-token`. Ve [Autenticacion](/getting-started/authentication) para mas detalles.
## Ejemplo de request
```bash theme={null}
curl -X POST https://api.shimli.app/v1/shop/products \
-H "Content-Type: application/json" \
-d '{
"name": "NAME PRODUCT",
"description": "DESCRIPTION_PRODUCT",
"descriptionai": "",
"code": "",
"price": 23.98,
"category": []
}'
```
## Respuesta
```json title="200 OK" theme={null}
{
"statusCode": 200,
"body": {
"err": false
}
}
```
# Remove Product
Source: https://docs.shimli.app/api-reference/shop/delete-product
Endpoint DELETE /v1/shop/products/ID_PRODUCT
`DELETE` `/v1/shop/products/ID_PRODUCT`
## Autenticacion
Este endpoint requiere tu token de API. Incluyelo en el body como `token` o como query param `token`/`api-token`. Ve [Autenticacion](/getting-started/authentication) para mas detalles.
## Ejemplo de request
```bash theme={null}
curl -X DELETE "https://api.shimli.app/v1/shop/products/ID_PRODUCT" \
-H "Content-Type: application/json"
```
## Respuesta
```json title="200 OK" theme={null}
{
"statusCode": 200,
"body": {
"err": false
}
}
```
# Get Product
Source: https://docs.shimli.app/api-reference/shop/get-product
Endpoint GET /v1/shop/products/ID_PRODUCT
`GET` `/v1/shop/products/ID_PRODUCT`
## Autenticacion
Este endpoint requiere tu token de API. Incluyelo en el body como `token` o como query param `token`/`api-token`. Ve [Autenticacion](/getting-started/authentication) para mas detalles.
## Ejemplo de request
```bash theme={null}
curl -X GET "https://api.shimli.app/v1/shop/products/ID_PRODUCT" \
-H "Content-Type: application/json"
```
## Respuesta
```json title="200 OK" theme={null}
{
"statusCode": 200,
"body": {
"err": false
}
}
```
# Update Product
Source: https://docs.shimli.app/api-reference/shop/update-product
Endpoint PUT /v1/shop/products/ID_PRODUCT
`PUT` `/v1/shop/products/ID_PRODUCT`
## Body
```json theme={null}
{
"image": "URL_IMAGE",
"name": "NAME",
"description": "",
"descriptionai": "",
"price": 0.0,
"category": [],
"status": 1,
"code": ""
}
```
## Autenticacion
Este endpoint requiere tu token de API. Incluyelo en el body como `token` o como query param `token`/`api-token`. Ve [Autenticacion](/getting-started/authentication) para mas detalles.
## Ejemplo de request
```bash theme={null}
curl -X PUT https://api.shimli.app/v1/shop/products/ID_PRODUCT \
-H "Content-Type: application/json" \
-d '{
"image": "URL_IMAGE",
"name": "NAME",
"description": "",
"descriptionai": "",
"price": 0.00,
"category": [],
"status": 1,
"code": ""
}'
```
## Respuesta
```json title="200 OK" theme={null}
{
"statusCode": 200,
"body": {
"err": false
}
}
```
# Create Link Short
Source: https://docs.shimli.app/api-reference/short-links/create
Endpoint POST /v1/short
`POST` `/v1/short`
## Body
```json theme={null}
{
"token": "TOKEN_SHIMLI",
"longUrl": "LONG_URL",
"idUrl": "ID (OPTIONAL)"
}
```
## Autenticacion
Este endpoint requiere tu token de API. Incluyelo en el body como `token` o como query param `token`/`api-token`. Ve [Autenticacion](/getting-started/authentication) para mas detalles.
## Ejemplo de request
```bash theme={null}
curl -X POST https://api.shimli.app/v1/short \
-H "Content-Type: application/json" \
-d '{
"token": "TOKEN_SHIMLI",
"longUrl": "LONG_URL",
"idUrl": "ID (OPTIONAL)"
}'
```
## Respuesta
```json title="200 OK" theme={null}
{
"statusCode": 200,
"body": {
"err": false
}
}
```
# Create Link Short Copy
Source: https://docs.shimli.app/api-reference/short-links/create-copy
Endpoint POST /v1/short
`POST` `/v1/short`
## Body
```json theme={null}
{
"token": "TOKEN_SHIMLI",
"longUrl": "LONG_URL",
"idUrl": "ID (OPTIONAL)"
}
```
## Autenticacion
Este endpoint requiere tu token de API. Incluyelo en el body como `token` o como query param `token`/`api-token`. Ve [Autenticacion](/getting-started/authentication) para mas detalles.
## Ejemplo de request
```bash theme={null}
curl -X POST https://api.shimli.app/v1/short \
-H "Content-Type: application/json" \
-d '{
"token": "TOKEN_SHIMLI",
"longUrl": "LONG_URL",
"idUrl": "ID (OPTIONAL)"
}'
```
## Respuesta
```json title="200 OK" theme={null}
{
"statusCode": 200,
"body": {
"err": false
}
}
```
# Update Link Short
Source: https://docs.shimli.app/api-reference/short-links/update
Endpoint PATCH /v1/short
`PATCH` `/v1/short`
## Body
```json theme={null}
{
"idUrl": "ID_SHORT_LINK",
"token": "TOKEN_SHIMLI",
"longUrl": "NEW_URL_LONG"
}
```
## Autenticacion
Este endpoint requiere tu token de API. Incluyelo en el body como `token` o como query param `token`/`api-token`. Ve [Autenticacion](/getting-started/authentication) para mas detalles.
## Ejemplo de request
```bash theme={null}
curl -X PATCH https://api.shimli.app/v1/short \
-H "Content-Type: application/json" \
-d '{
"idUrl": "ID_SHORT_LINK",
"token": "TOKEN_SHIMLI",
"longUrl": "NEW_URL_LONG"
}'
```
## Respuesta
```json title="200 OK" theme={null}
{
"statusCode": 200,
"body": {
"err": false
}
}
```
# Agosto 2026
Source: https://docs.shimli.app/changelog/august-2026
Novedades de Shimli de agosto 2026 — inbox con mensajes programados, recordatorios, bases de datos desde la conversación, búsqueda en la conversación y más.
Agosto trajo mejoras importantes al **inbox de Shimli**, al **Flow Builder**, al correo electrónico y a **Shimli Admin**, con una idea central: que tu equipo pueda hacer más sin salir de la plataforma.
## Inbox
### Mensajes programados
Ahora puedes redactar un mensaje y elegir cuándo enviarlo: **en 1 hora**, **en 3 horas**, **mañana**, **la próxima semana** o una fecha y hora exactas. El mensaje sale solo, aunque no estés conectado.
### Recordatorios internos
Puedes programar **recordatorios** que aparecen en la conversación a la hora que elijas — "recordá mandarle la cotización". Ningún seguimiento se te escapa.
### Flows programados
También puedes programar la ejecución de un **flujo automatizado**: eliges el flujo y la hora, y Shimli lo dispara por ti.
### Bases de datos desde la conversación
Sin salir del chat puedes abrir el panel **Form or Database** y agregar, editar o eliminar registros de tus bases de datos. Y con **Completar con IA**, la IA lee la conversación y llena los campos del registro con los datos que el cliente ya te dio — sin transcribir nada.
### Búsqueda dentro de la conversación
Nueva búsqueda dentro de cada conversación, con dos pestañas: **Mensajes** (texto) y **Media** (fotos, videos y documentos compartidos).
### Llamadas de WhatsApp o de línea telefónica
Al iniciar una llamada ahora eliges el tipo: **llamada de WhatsApp** (sale desde tu número conectado) o **llamada regular** (por tu planta telefónica).
### Fijar conversaciones y marcar como no leídas
Desde el menú de cada conversación puedes **fijarla** arriba de la lista o **marcarla como no leída** para volver a ella después.
### El compositor ahora tiene cuatro modos
El selector junto al campo de texto te permite cambiar entre **Mensaje**, **Plantilla**, **Flow** (formulario de WhatsApp) y **Nota** privada.
### Respuestas rápidas desde el compositor
Los agentes pueden **crear respuestas rápidas** sin salir del inbox: definen un nombre y un atajo de texto, y la insertan escribiendo el atajo.
## Flow Builder
### Constructor renovado
El Flow Builder ahora puede abrirse a pantalla completa, con barra superior propia, selector de flujo, barra de herramientas flotante y respeto por el tema del panel. Los flujos siguen siendo los mismos: no hay migración.
### Disparador por cambios en una base de datos
Un flujo también puede arrancar cuando una fila de una base de datos se agrega, se edita o se elimina. Sirve para bienvenidas tras un formulario, avisos por cambio de estado o bajas automáticas.
## Correo electrónico
### Envío transaccional por API
Ahora también puedes enviar **un solo correo transaccional** desde la API, con una plantilla guardada y un remitente verificado.
### Nuevo paso de correo dentro de un flujo
El Flow Builder incorpora un paso de correo que puede enviar una plantilla y, si activas la espera, ramificar según el evento del envío: entregado, rebotado, abierto, click, vencimiento de la espera o fallo de envío.
### Duplicar plantillas
Las plantillas de correo ahora se pueden **duplicar** desde la lista.
## Shimli Admin
### Pantallas de acceso mejoradas
Las pantallas de **login, crear cuenta y recuperar acceso** ahora muestran **tarjetas informativas rotativas** sobre Shimli. El acceso deja de ser una pantalla estática y da contexto útil sobre el producto mientras la persona ingresa.
### Gestión de agentes
La gestión de agentes recibió varias mejoras visibles:
* El selector de **áreas** ahora incluye **buscador** y muestra el **catálogo completo**.
* El **correo electrónico** se define al crear el agente y luego **ya no se edita**.
* Al abrir la edición, el estado mostrado ahora coincide con el **estado real** del agente.
* El estado del agente se simplificó a dos opciones: **Activo** e **Inactivo**.
## Resumen
* Programación de mensajes, recordatorios y flows
* Bases de datos editables desde la conversación, con autocompletado por IA
* Búsqueda dentro de la conversación (mensajes y media)
* Llamadas de WhatsApp o de línea telefónica
* Fijar conversaciones, marcar como no leídas
* Compositor con cuatro modos: mensaje, plantilla, flow y nota
* Creación de respuestas rápidas desde el compositor
* Nuevo Flow Builder a pantalla completa
* Disparador de flujos por cambios en una base de datos
* Envío de correo transaccional por API
* Nuevo paso de correo dentro de un flujo
* Duplicación de plantillas de correo
* Pantallas de acceso con tarjetas informativas rotativas
* Mejoras en gestión de agentes: buscador de áreas, correo no editable al editar y estados Activo / Inactivo
Todos los detalles en [Bandeja de entrada (Inbox)](/guides/inbox), [Flow Builder](/flows/introduction), [Bases de datos](/guides/databases), [Email Marketing](/guides/email-marketing) y [Configuración del CRM](/guides/crm-configuration).
# Changelog
Source: https://docs.shimli.app/changelog/introduction
Historial de novedades y cambios en Shimli.
Bienvenido al changelog de Shimli. Aquí documentamos las novedades, mejoras y cambios relevantes de la plataforma, organizados por mes.
## Versiones recientes
* [Octubre 2026](/changelog/october-2026) — Plantillas de autenticación (OTP) para WhatsApp, reglas de Meta y mejoras del Flow Builder
* [Septiembre 2026](/changelog/september-2026) — Agentes de IA con gestiones en segundo plano, Flow Builder más fluido, notas de voz, correos con fidelidad total y privacidad reforzada
* [Agosto 2026](/changelog/august-2026) — Inbox, Flow Builder renovado, triggers por base de datos y correo transaccional
* [Julio 2026](/changelog/july-2026) — Usernames, verificación OBA, control de permisos, supervisor de inbox, knowledge para agentes, análisis de flujos
* [Junio 2026](/changelog/june-2026) — Email marketing con IA, Polls AI, agente de cobranza, manual de marca
* [Mayo 2026](/changelog/may-2026) — Lanzamiento 2026, nuevas capacidades de IA
# Julio 2026
Source: https://docs.shimli.app/changelog/july-2026
Novedades de Shimli de julio 2026 — usernames, verificación OBA, control de permisos, supervisor de inbox, knowledge para agentes, análisis de flujos.
Julio trajo 9 novedades importantes a Shimli, centradas en tres pilares: **más control para tu equipo**, **WhatsApp más potente** e **IA que trabaja por ti**.
## WhatsApp
### Nombres de usuario en WhatsApp
WhatsApp comenzó a usar **nombres de usuario** (@handle). Un cambio enorme para cómo tus clientes te encuentran: en lugar de necesitar tu número, buscan tu @username directamente.
Shimli ya está listo para manejarlo. Ve a [Usernames](/whatsapp/usernames) para reservar el tuyo.
Se mandó un correo de aviso a todos los clientes y aparece una notificación in-app al ingresar a Shimli pidiendo reservar el nombre.
### Verificación de Official Business Account
Ahora puedes solicitar el **check azul** de verificación de WhatsApp Business directamente desde Shimli, sin necesidad de ir al Meta Business Manager.
Ve a [Verificación de OBA](/whatsapp/verification) para más detalles.
## Control de equipo
### Control de permisos y presupuesto por agente
Los administradores ahora pueden definir **permisos granulares** y **presupuestos** por agente. Esto permite:
* Limitar cuántos mensajes puede enviar un agente por día/semana
* Restringir acceso a ciertas campañas o listas
* Controlar quién puede enviar campañas masivas
### Rol de supervisor para el inbox
Nuevo rol de **supervisor** que puede monitorear y gestionar conversaciones del inbox sin ser un agente asignado. Ideal para equipos de quality assurance y soporte de segundo nivel.
## IA
### Knowledge para agentes de WhatsApp
Puedes darle **conocimiento (knowledge)** a tus agentes de WhatsApp — catálogos, políticas, FAQs — para que respondan con una precisión increíble, basados en tu información real.
### Plantillas que se escriben solas
El constructor de plantillas ahora usa IA: **describes lo que quieres** y la IA redacta la plantilla completa, declara los ejemplos que Meta pide y la envía directo.
### Resolución de rechazos de Meta
Si Meta rechaza una plantilla, la IA **te dice por qué** y te ofrece un botón para corregirla. Y si Meta recategoriza una plantilla, Shimli lo detecta y puedes apelar desde la plataforma.
### Correos redactados por IA
Los correos de marketing ahora pueden ser **redactados por IA** dentro de Shimli, con contexto de la campaña y el segmento.
### WhatsApp Flows con IA
El constructor de **WhatsApp Flows** (formularios dentro de la conversación) ahora se arma con IA. Tu cliente no sale de WhatsApp, no abre un link, no llena nada en otra página.
### Envíos de marketing en el mejor momento
La IA ahora puede **lanzar campañas en el mejor momento** según el comportamiento histórico de tus contactos, optimizando la tasa de apertura.
## Análisis
### Análisis de ejecución de flujos
Nuevo panel de **análisis de ejecución de flujos** que te muestra dónde los clientes abandonan, qué pasos tienen mayor fricción y cómo optimizar tus automatizaciones.
## Resumen
| Novedad | Categoría |
| - | - |
| Nombres de usuario en WhatsApp | WhatsApp |
| Verificación de OBA | WhatsApp |
| Control de permisos y presupuesto por agente | Equipo |
| Rol de supervisor para el inbox | Equipo |
| Knowledge para agentes de WhatsApp | IA |
| Plantillas que se escriben solas | IA |
| Resolución de rechazos de Meta | IA |
| Correos redactados por IA | IA |
| WhatsApp Flows con IA | IA |
| Envíos de marketing en el mejor momento | IA |
| Análisis de ejecución de flujos | Análisis |
# Junio 2026
Source: https://docs.shimli.app/changelog/june-2026
Email Marketing con IA, Polls AI, Shimli Assistant en el inbox, permisos granulares y agente de cobros autónomo.
Junio trajo la expansión de Shimli a nuevos canales y módulos, con un enfoque en **IA que opera de principio a fin**.
## Email Marketing con IA
Nuevo módulo de email marketing que replica la experiencia de las campañas de WhatsApp:
* **Remitentes verificados** por correo individual (validación por link) o por dominio (DNS).
* **Plantillas creadas con IA**: describes el correo en lenguaje natural o subes una imagen/PDF/video, y el asistente lo diseña listo para enviar.
* **Variables dinámicas** en asunto, texto y HTML.
* **Métricas tipo embudo**: enviados, entregados, abiertos, clics, rebotes.
* **Motivos de rechazo** detallados por cada correo.
* **Flujos cruzados**: si el contacto no abre el email, se dispara un WhatsApp automáticamente.
* **Integración con el inbox**: envía correos durante una conversación de WhatsApp sin cambiar de herramienta.
Ve a [Email Marketing](/guides/email-marketing) para más detalle.
## Polls AI
Nuevo módulo de encuestas con análisis por IA:
* Crea encuestas (calificación, opción múltiple, abiertas) y envía por WhatsApp.
* Métricas en tiempo real: alcance, tasa de respuesta, detalle por pregunta.
* **Asistente de IA** que analiza los resultados en lenguaje natural y genera insights procesables — sin exportar a Excel.
Ve a [Polls AI](/guides/polls-ai) para más detalle.
## Shimli Assistant en el inbox
El inbox dejó de ser una bandeja pasiva. Al abrir, el **Shimli Assistant**:
1. Prioriza la cola y resalta lo urgente.
2. Redacta respuestas listas para aprobar.
3. Balancea la asignación entre agentes.
4. Mantiene las conversaciones sin asignar a la vista.
Ve a [Inbox](/guides/inbox) para más detalle.
## Permisos y roles granulares
Los administradores ahora pueden definir **permisos por módulo** para cada agente: quién manda campañas, quién sube bases de datos, quién ve qué. Reemplaza la práctica de dar admin a todos.
Ve a [Permisos de usuario](/guides/user-permissions) para más detalle.
## Agente de cobros con IA
Shimli puede operar un **agente de cobros autónomo** que desde un Excel de cartera vencida:
* Lanza la campaña masiva personalizada 1:1.
* Sostiene conversaciones individuales con acceso a los datos del Excel.
* Procesa notas de audio del cliente (multimodal).
* Mantiene tono institucional ante insultos y números equivocados.
* Cierra compromisos de pago con fecha, monto y link de pago directo.
Ve a [Agente de cobros con IA](/guides/ai-debt-collection) para más detalle.
## Campañas renovadas
Mejoras a las campañas existentes:
* **Vista de embudo**: envíos → entregados → leídos con caída visible.
* **Motivos de no-entrega**: Shimli te dice por qué cada mensaje no se entregó (motivo exacto de Meta).
* **Asistente de IA**: analiza la campaña en lenguaje natural y exporta segmentos.
* **Gráficas renovadas** más claras.
## Resumen
| Novedad | Categoría |
| - | - |
| Email Marketing con IA | Multi-canal |
| Polls AI | IA |
| Shimli Assistant en el inbox | IA |
| Permisos y roles granulares | Equipo |
| Agente de cobros con IA | IA |
| Campañas renovadas (embudo, rechazos, IA) | Marketing |
# Mayo 2026
Source: https://docs.shimli.app/changelog/may-2026
Lanzamiento 2026 de Shimli con nuevas capacidades de IA y multi-canal.
Mayo marcó el lanzamiento de la versión 2026 de Shimli, con un enfoque en **IA integrada** y **multi-canal real**.
## Novedades principales
### Plataforma unificada multi-canal
Shimli unificó WhatsApp, Facebook Messenger, SMS y correo en una sola bandeja de entrada conversacional. Los agentes pueden gestionar conversaciones de todos los canales desde una sola interfaz.
### Agentes de IA nativos
Los agentes de IA dejaron de ser un add-on y pasaron a ser parte nativa de la plataforma. Cada conversación puede ser atendida inicialmente por IA y escalada a humano cuando sea necesario.
### CRM conversacional
El CRM se integró directamente en la bandeja de entrada. Cada conversación es un registro de CRM con historial, tags, asignación y campos personalizados.
### API v3
Lanzamiento de la API v3 con 30+ endpoints para integrar mensajería, contactos, campañas, shop y CRM en sistemas externos.
# Octubre 2026
Source: https://docs.shimli.app/changelog/october-2026
Envío de códigos de autenticación OTP por WhatsApp y mejoras en el Flow Builder.
## Flow Builder
### Pasos de IA con controles propios
**Agente de IA** y **Transformar con IA** se muestran y configuran como pasos distintos. Los controles de Transformar con IA vuelven a estar disponibles en su panel, también al usar el tema oscuro. [Conoce las diferencias entre los pasos](/flows/nodes#inteligencia-artificial).
### Recuperación de configuraciones existentes
Al abrir o configurar pasos de IA guardados con datos incompletos o en un formato anterior, el editor intenta normalizar su configuración. Esto incluye **Transformar con IA** y **Audio o imagen a texto**. Los problemas del panel de configuración ya no deberían bloquear la edición del flujo; revisa los pasos recuperados antes de publicar cambios.
### Condiciones visibles al retomar un flujo
Las condiciones de ramificación ya guardadas vuelven a mostrarse en el panel lateral y conservan su evaluación durante la ejecución. Puedes revisarlas y editarlas desde [Condición](/flows/nodes#condición).
Estas mejoras corresponden al editor visual; no incluyen cambios de voz. La validación de las configuraciones en el servidor se había actualizado previamente.
## Envío de códigos OTP por WhatsApp
Puedes enviar desde Inbox una plantilla de WhatsApp de la categoría **Authentication** para entregar un código de un solo uso. El código vigente se proporciona al momento del envío y WhatsApp lo presenta de acuerdo con el método de entrega configurado en la plantilla.
El usuario puede copiar el código o, cuando la plantilla y su dispositivo lo permiten, usar autocompletado con uno o ningún toque. Para preparar y enviar una plantilla, consulta las guías de [creación de plantillas](/guides/templates#plantillas-de-autenticación-otp) y [envío desde Inbox](/guides/send-whatsapp-message#enviar-una-plantilla-de-autenticación-otp-desde-inbox).
El código debe ser generado y validado por el sistema de autenticación de tu servicio; usa uno vigente y respeta su tiempo de expiración.
## Mejoras del Flow Builder en Beta V2
### Plantillas de WhatsApp en automatizaciones
El paso **Plantilla** permite configurar plantillas de la categoría **Authentication** para enviar códigos OTP desde un flujo, de acuerdo con las opciones de entrega disponibles en la plantilla seleccionada. Consulta el [catálogo de nodos](/flows/nodes).
### Webhooks más seguros al publicar
En pasos de inicio Webhook, la dirección se conserva al alternar entre Webflow y Flow-Section. Los flujos nuevos incluyen un paso **Get Started** automáticamente. Si cambias la URL del webhook, al publicar verás la dirección anterior y la nueva y deberás confirmar el cambio.
### Selección de plantilla y carrusel
Se corrigió la selección inicial y el cambio de plantilla en los pasos WABA, incluido el caso de plantillas de carrusel. Al editar un flujo, revisa que esté seleccionada la plantilla que quieres enviar antes de publicarlo.
# Septiembre 2026
Source: https://docs.shimli.app/changelog/september-2026
Novedades de Shimli de septiembre 2026 — agentes de IA que gestionan en segundo plano, Flow Builder más fluido, notas de voz, correos con fidelidad total y privacidad reforzada.
Septiembre trae mejoras en dos frentes: tus **agentes de IA** ahora gestionan consultas largas sin dejar la conversación en pausa, y la **experiencia de construcción** es más fluida que nunca — con notas de voz, correos que se ven exactamente como los diseñaste y privacidad reforzada en toda la plataforma.
## Agentes de IA
### Gestiones en segundo plano, conversación siempre activa
Tus agentes de IA ahora pueden realizar **consultas externas o gestiones que toman más tiempo** — verificar tarifas, confirmar disponibilidad, consultar tus sistemas — sin dejar al cliente esperando en silencio.
Cuando una gestión requiere un momento extra, el agente envía un **acuse inmediato** ("dame un momento, estoy consultando la disponibilidad") y entrega el resultado final de forma natural en cuanto está listo. La conversación nunca se congela: sin silencios incómodos, sin sensación de abandono y sin que tu cliente tenga que repetir su consulta.
## Flow Builder
### Un lienzo más rápido y fluido
Optimización integral del lienzo de diseño: la navegación, el arrastre de bloques y el guardado responden de inmediato, sin pausas — incluso en flujos extensos con decenas de pasos. Diseñar una automatización grande se siente tan ligero como empezar una nueva.
## Asistente de Flujos
### Notas de voz en el Asistente de Flujos
Ahora puedes hablarle al **Asistente de Flujos** directamente: el acceso al micrófono quedó habilitado por completo dentro del Flow Builder, sin interrupciones de permisos mientras trabajas.
Describe el flujo que necesitas con tu voz — "cuando un cliente pregunte por su pedido, consulta el estado y responde" — y el asistente lo construye contigo. Ideal para diseñar automatizaciones lejos del teclado o dictar ajustes mientras revisas el flujo en pantalla.
También puedes **probar tus flujos con notas de voz** directamente desde la previsualización del constructor: graba un audio como lo haría tu cliente y valida cómo responde el flujo antes de publicarlo.
## Correo electrónico
### Diseño de correos con fidelidad total
El editor de plantillas de correo ahora **preserva exactamente los estilos, colores y formatos visuales** de tu diseño: lo que ves en el editor es lo que llega a la bandeja de tus contactos, en campañas y en comunicaciones automáticas.
Esto aplica tanto a las plantillas que diseñas desde cero como a las que creas con el asistente de IA o importas desde HTML.
## Plataforma
### Experiencia multilingüe pulida
Cobertura completa de traducciones en **español, inglés y portugués** en toda la plataforma, eliminando textos e identificadores sin traducir. Cada miembro de tu equipo trabaja en su idioma, sin excepciones en ninguna pantalla.
### Centro de estado de cuenta
Nueva pantalla de **estado de cuenta** con avisos claros sobre tu facturación y la disponibilidad del servicio, para que siempre sepas en qué punto está tu suscripción y qué hacer si algo necesita tu atención.
### Privacidad y confidencialidad reforzada
Blindamos el manejo de datos en toda la plataforma: las conversaciones de tus clientes, sus contraseñas y su información sensible se tratan con la **máxima discreción y seguridad**, de principio a fin. Lo que tus clientes comparten contigo, queda entre ustedes.
# Agente de IA en el flujo
Source: https://docs.shimli.app/flows/ai-agent
El paso que sostiene la conversación por su cuenta — instrucciones, límites, habilidades, acciones y cuándo entrega el chat a un humano.
El **Agente de IA** es un paso especial del Flow Builder: en vez de enviar un mensaje y seguir, **se queda sosteniendo la conversación**. Responde, decide, usa herramientas y sabe cuándo entregar el chat a una persona.
Mientras el agente está atendiendo, el flujo no avanza a ningún otro paso. Es él quien conversa.
Funciona en canales de chat y de voz.
![Cómo está compuesto un agente de IA]()
## Identidad: quién es tu agente
Lo primero que defines es cómo se comporta:
| Campo | Para qué |
| - | - |
| **Nombre** | Cómo se llama |
| **Descripción** | Qué hace, en una línea |
| **Instrucciones** | El corazón del agente: cómo debe comportarse, qué tono usa, qué hace y qué no |
| **Olvidar entrenamiento** | Si lo activas, responde **solo** con tu conocimiento, tus instrucciones y lo que devuelvan sus herramientas — nunca con lo que sabía de antes |
**"Olvidar entrenamiento"** ancla al agente exclusivamente en tu información: responde con tus precios, tus políticas y tu disponibilidad reales, y nada más. Es la opción indicada cuando la exactitud manda.
## Conocimiento
Súbele los documentos con los que debe responder: PDF, Word e imágenes.
Es la diferencia entre un agente que suena bien y uno que responde correcto. Catálogos, políticas de devolución, preguntas frecuentes, listas de precios.
## Habilidades
Las **habilidades** son instrucciones específicas para situaciones concretas. Cada una tiene:
* **Un título** que dice **cuándo aplica**: "Devoluciones y reembolsos", "Hospedaje", "Reclamos de garantía".
* **Un texto** que explica cómo manejar esa situación.
El agente elige la habilidad por su título, así que títulos precisos lo hacen más certero. "Política de envíos", "Formas de pago" y "Garantías" funcionan mejor que una sola "Todo sobre la empresa": cuanto más específica es cada habilidad, más exacta es la respuesta.
Las habilidades **no ejecutan nada**: son instrucciones que se le dan al agente. Lo que ejecuta cosas son las acciones.
## Acciones: lo que el agente puede hacer
Las **acciones** son las herramientas del agente. Sin ellas solo conversa; con ellas trabaja.
| Tipo de acción | Qué le permite hacer |
| - | - |
| **Entregar la conversación** | Pasar el chat a un humano |
| **Base de datos** | Buscar, insertar, actualizar o borrar registros |
| **Tienda** | Crear y modificar pedidos, ver categorías y productos, y manejar el carrito |
| **API / conector** | Llamar a un sistema externo |
| **Ejecutar código** | Correr código Python |
| **Código asistido** | Describir qué necesita y que el modelo escriba y ejecute el código |
| **Navegar internet** | Buscar y operar en la web |
| **Crear tarea** | Agendar algo para después |
| **Servidor MCP** | Conectarse a un servidor de herramientas externo |
Cada acción tiene un nombre y una descripción. La **descripción es lo que el agente lee para decidir cuándo usarla** — escribe ahí la condición, no solo una etiqueta.
El agente decide por sí solo cuándo pasar la conversación al resto del flujo: activa la salida en las acciones que quieras usar como puerta —entregar a un humano, ir a pagar, abrir un ticket— y esas se vuelven los caminos disponibles en el canvas.
## La entrega a un humano
Es la acción más importante y la que más se configura mal.
El agente lee la descripción para decidir cuándo entregar. No pongas "Hablar con un asesor": pon en qué situaciones debe hacerlo.
Es lo que se le dice a la persona justo antes de pasar con un humano. Escríbelo siempre: un *"te comunico con un asesor, un momento"* hace que la transición se sienta atendida y no como una pausa.
Los campos que el agente debe completar antes de entregar: el motivo, el número de pedido, lo que necesite quien reciba el chat. Puedes dejarlos libres o limitarlos a una lista de valores.
La entrega siempre tiene salida y no se puede desactivar. Conéctala al resto del flujo — normalmente a un paso de **Abrir ticket**.
Conecta cada salida que hayas activado al paso que corresponda. Así cada decisión que toma el agente tiene continuidad: la persona pasa al área correcta, al pago o al cierre, sin repetir lo que ya contó.
Llenar los datos que viaja la entrega tiene dos beneficios: quien recibe el chat llega con contexto, y las reglas de seguridad pueden verificar condiciones — solo se puede verificar un dato que efectivamente viaja.
## Reglas de seguridad
Las **reglas** son los límites del agente. Cada una tiene un nombre, una descripción, qué vigila y qué hacer cuando se incumple: registrarlo, advertir o bloquear.
Pueden vigilar tres cosas:
| Vigila | Para qué sirve |
| - | - |
| **Los mensajes** | Qué cuenta como violación, qué debe decir en su lugar, qué no puede decir nunca |
| **La entrega a un humano** | En qué casos **no** puede entregar la conversación, y opcionalmente en cuáles sí |
| **Acciones obligatorias** | Qué tiene que hacer sí o sí antes de continuar |
Tienes control fino sobre cuándo el agente puede usar cada acción. La forma más práctica de aprovecharlo es definir solo los casos que quieres bloquear —fuera de horario, clientes sin cuenta activa— y dejar el resto abierto: el agente conserva todos sus caminos y tú acotas exactamente lo que te interesa acotar.
## Capacidades
Además de las acciones, puedes activarle capacidades generales:
* Interpretar código
* Buscar en internet
* Generar imágenes
* Generar video
* Operar la computadora
* Reconocer y comparar rostros
* Gestionar tareas
## Recomendaciones
Por las **instrucciones** y el **conocimiento**. Un agente con buenas instrucciones y tus documentos reales ya resuelve la mayor parte de las conversaciones. Las acciones y las reglas las vas sumando después, a medida que ves qué más quieres que haga por su cuenta.
Activa **olvidar entrenamiento**, cárgale tu conocimiento real y suma una regla de seguridad para los temas donde la exactitud manda: precios, plazos y disponibilidad.
Las instrucciones son cómo se comporta **siempre**. Una habilidad es cómo maneja **una situación concreta**. Si tienes que escribir "cuando el cliente pregunte por X…", eso es una habilidad.
El agente sostiene la conversación mientras la esté resolviendo, y la entrega en cuanto se da una de las acciones que configuraste como salida. Deja al menos una de entrega activada y conectada: esa es la señal que usa para pasar la posta.
# Qué es el Flow Builder
Source: https://docs.shimli.app/flows/introduction
Flow Builder de Shimli: el espacio visual para diseñar cómo la IA ejecuta ventas, cobranzas, soporte y operaciones sobre tus sistemas.
El **Flow Builder** es el espacio visual donde diseñas cómo la IA de Shimli ejecuta una operación: qué entiende, qué consulta, qué decide y cuándo entrega la conversación a una persona.
Es la capa que permite que la plataforma ejecute procesos reales de la empresa de forma continua.
## Lo que puedes construir
Con los mismos bloques puedes armar desde un menú de opciones hasta una operación completa:
* **Atención automática** que responde, entiende y resuelve sin intervención.
* **Ventas de principio a fin**: catálogo, carrito, pedido y pago dentro de la conversación.
* **Captura de datos** con formularios nativos de WhatsApp o preguntas guiadas.
* **Conexión con tus sistemas**: consulta tu ERP, tu inventario o tu CRM en tiempo real.
* **Seguimiento programado**: recordatorios, carritos abandonados, reactivaciones.
* **Entrega inteligente a tu equipo**, con el contexto ya resuelto y la persona correcta asignada.
Shimli trae **73 pasos** listos para usar, agrupados por familia: mensajería, disparadores, SMS y voz, CRM, tienda, base de datos, inteligencia artificial y utilidades. Los tienes todos en el [catálogo de nodos](/flows/nodes).
## Cómo se arma un flujo
Un flujo son **pasos** conectados entre sí.
* Cada paso hace **una cosa concreta**: enviar un mensaje, esperar una respuesta, consultar una base de datos, abrir un ticket.
* Los pasos se unen con **conexiones**, y la conversación avanza siguiendo esas líneas.
* Todo flujo arranca en un paso de **inicio** y cada camino cierra en un paso de **fin**.
Arrastras el paso al canvas, lo configuras en el panel lateral y lo conectas. No se escribe código en ningún momento.
## La nueva experiencia del constructor
El Flow Builder renovado mantiene **los mismos flujos de siempre**: no hay migración y no cambia dónde se guardan. Lo que cambia es la experiencia de trabajo.
* **Ocupa toda la pantalla** para darte un canvas mucho más grande.
* Trae **barra superior propia** con volver al listado, marca, ruta del flujo, selector de versión y acciones.
* El nombre del flujo también funciona como **selector** para cambiar de flujo sin salir del constructor.
* Incluye una **barra de herramientas flotante** para navegar, seleccionar, buscar pasos, hacer zoom y ajustar a pantalla.
* Respeta el **tema del panel**: claro u oscuro, y se actualiza en el momento si cambias de tema.
Si tu cuenta tiene el nuevo constructor, entras a él desde el mismo listado de flujos. Tus flujos siguen ahí y funcionan igual.
## El nuevo constructor trabaja con ramas y publicaciones
A diferencia del constructor anterior, el flujo que está en producción **no se edita directamente**. El trabajo se hace en **ramas**, como si fueran versiones paralelas del mismo flujo, y luego decides cuál publicar.
### Qué significa esto en la práctica
* Los flujos nuevos incluyen automáticamente un paso **Get Started** para iniciar el recorrido.
* En un paso de inicio **Webhook**, la dirección URL se conserva al cambiar el tipo entre Webflow y Flow-Section. No es necesario volver a ingresarla al cambiar esa selección.
* El flujo activo en producción queda protegido.
* Los cambios se hacen en una **rama** o **draft**.
* Cuando publicas, puedes renombrar la versión que pasa a producción y la versión que deja de estar activa.
### Confirmación del webhook al publicar
Si modificaste la URL del webhook, antes de publicar el constructor muestra la dirección anterior y la nueva y te pide confirmar el cambio. Revisa ambas antes de continuar: los sistemas que llaman al flujo deben usar la URL vigente. No hay una acción para renovar la dirección automáticamente.
### Al publicar te pide tres decisiones
| Pregunta | Qué significa |
| - | - |
| **Nombre del nuevo draft en producción** | Cómo quedará llamada la versión que acabas de publicar |
| **Nombre del draft que deja producción** | Cómo quedará llamada la versión anterior, ahora guardada como borrador |
| **Cómo aplicarlo** | Si reinicias las corridas activas o publicas en silencio |
### Publicación silenciosa vs reinicio de corridas
| Opción | Qué pasa |
| - | - |
| **Publicación silenciosa** | Las conversaciones ya iniciadas siguen con la versión anterior hasta terminar; las nuevas entradas usan la versión publicada |
| **Reiniciar corridas** | Detiene las corridas activas y las lleva a la nueva versión |
Este modelo evita que una edición en curso rompa un flujo que ya está corriendo en producción.
## Un flujo también puede arrancar cuando cambia una fila
Además de los inicios por mensaje, webhook, campaña o subflujo, ahora un flujo puede dispararse cuando **una fila de una base de datos se agrega, se edita o se elimina**.
Casos típicos:
* alguien completa un formulario y arranca la bienvenida,
* un operador cambia una columna a «Aprobado» y se avisa al cliente,
* se elimina un registro y se dispara una baja.
### Qué configura este inicio
| Ajuste | Qué controla |
| - | - |
| **Base de datos** | Qué lista se vigila |
| **Eventos** | Agregar, editar o eliminar |
| **Orígenes** | De dónde vino el cambio |
| **Columnas** | Qué columnas pueden despertar el flujo |
| **Columna de destino** | De dónde sale la persona con la que hablará el flujo |
| **Máximo por minuto** | Tope de ejecuciones por minuto |
Si no marcas eventos, se escuchan los tres. Si no marcas orígenes, se escuchan **formulario, carga manual y API**; quedan fuera «otro flujo» e «importación».
El filtro por columnas **solo aplica a las ediciones**. En agregar o eliminar, la fila entera cambia.
### Variables disponibles
| Variable | Qué trae |
| - | - |
| `{{op}}` | Si la fila se agregó, editó o eliminó |
| `{{origen}}` | De dónde vino el cambio |
| `{{rowId}}` | Identificador de la fila |
| `{{old}}` | La fila antes del cambio |
| `{{new}}` | La fila después del cambio |
| `{{changed}}` | Solo lo que cambió |
Ejemplo:
```
Hola {{new.values.nombre}}, tu pedido pasó a {{new.values.estado}}.
```
Escribir `{{new}}` a secas vuelca la fila completa dentro del mensaje. Lo correcto es usar columnas específicas como `{{new.values.nombre}}`.
### Tres protecciones
* **Las cargas masivas no disparan el flujo**.
* **Las cadenas se cortan al segundo salto** si un flujo escribe una fila que dispara otro flujo.
* **Hay un tope por minuto** configurable en el mismo paso.
## Diseñar un flujo sólido
### Los caminos que abre cada paso
La mayoría de los pasos siguen de largo al siguiente. Otros abren rutas, y ahí es donde el flujo toma decisiones:
| Tipo de paso | Caminos que abre |
| - | - |
| Enviar un mensaje, guardar un dato, consultar la tienda | Uno — sigue al siguiente |
| Condición, horario de atención | Uno por cada caso que definas, más el camino alterno |
| Esperar respuesta, formulario | Uno si contestó, otro si pasó el tiempo |
| Botones con espera activada | Uno por cada botón |
| Llamada a un sistema externo | Uno si respondió, otro si no |
| Transferir una llamada | Uno si contestaron, otro si no |
| Fin, ir a un paso, ir a otro flujo | Ninguno — ahí cierra el camino |
## Diseñar un flujo sólido
Tres criterios que hacen la diferencia entre un flujo que funciona y uno que además se sostiene en el tiempo.
**Definí siempre el camino alterno.** Los pasos que ramifican traen una salida adicional para lo que no encaja en ninguna condición. Conectala a un mensaje de reintento o a una entrega con un humano: así el cliente siempre recibe una respuesta, incluso cuando dice algo que no anticipaste.
**Cerrá cada camino con un paso de fin.** El paso de fin es el que da por terminada la conversación y la deja lista para empezar limpia la próxima vez. Recorré cada rama hasta el final y confirmá que llega ahí — es lo que mantiene el historial ordenado y las métricas correctas.
**Probá el flujo antes de publicarlo.** Recorrelo como si fueras el cliente, incluyendo los caminos alternos. Es la forma más rápida de ver el flujo con los ojos de quien te escribe.
## Las variables
Las **variables** son los datos que el flujo va recordando durante la conversación: el nombre que dijo la persona, el resultado de una búsqueda, lo que devolvió tu sistema.
Se escriben entre llaves dobles y se usan en cualquier campo de texto:
```
Hola {{nombre}}, tu pedido {{numeroPedido}} va en camino.
```
Las producen los pasos que capturan o generan información:
| Paso | Qué guarda |
| - | - |
| **Asignar variable** | Un valor que vos definís |
| **Guardar respuesta** | Lo último que dijo la persona |
| **Guardar archivo** | El enlace del archivo que enviaron |
| **Esperar respuesta** | Lo que contestaron |
| **Buscar en base de datos** | Los registros encontrados |
| **Llamada a un sistema externo** | Los datos que devolvió |
| **Pasos de IA** | El resultado del modelo |
Con esto personalizás cada mensaje con el dato real de esa persona, sin plantillas genéricas.
## Los canales
Un flujo trabaja sobre un canal: WhatsApp, Telegram, Facebook, Instagram, Live Chat, correo, SMS o llamadas telefónicas.
Cada canal tiene sus propias posibilidades, y el Flow Builder las aprovecha al máximo:
| | WhatsApp | Telegram | Facebook / Instagram |
| - | - | - | - |
| Botones por mensaje | 3 | 20 | 3 |
| Opciones en una lista | 10 | 20 | 13 |
| Carrusel de tarjetas | Hasta 10 | — | — |
| Plantillas | Sí | — | Facebook |
| Formularios nativos | Sí | — | — |
## El asistente de IA del canvas
No hace falta armar todo a mano. El Flow Builder tiene un **asistente de IA** al que le escribís en español lo que querés.
Por ejemplo: *"agregá una rama para pedidos a domicilio"* o *"¿qué hace este flujo cuando el cliente pregunta por el envío?"*.
No necesita que le expliques nada. Recorre todos los pasos, entiende cómo se conectan y te responde con el contexto de tu automatización real.
Te muestra cambio por cambio lo que va a hacer, antes de tocar el canvas.
Nada se aplica sin tu aprobación.
![Resumen generado por la IA sobre un flujo]()
![Revisión de cambios propuestos por la IA]()
Es especialmente útil con flujos grandes o que no armaste vos: le preguntás qué hace y te lo explica por partes, en lenguaje normal.
## Por dónde seguir
# Catálogo de nodos
Source: https://docs.shimli.app/flows/nodes
Los 73 pasos del Flow Builder de Shimli, agrupados por familia — qué hace cada uno y cuándo usarlo.
Todos los pasos disponibles en el canvas, por familia. Si buscas cómo se conectan entre sí, empieza por [Qué es el Flow Builder](/flows/introduction).
## Nodos de inicio
Todo flujo arranca en uno. El tipo que elijas define **cuándo se dispara** y qué información trae.
| Paso | Cuándo arranca |
| - | - |
| **General** | Alguien escribe y ningún otro flujo reclama ese mensaje. Es el punto de entrada por defecto. |
| **Webhook** | Un sistema externo llama a una dirección que Shimli genera. Lo que envíen queda disponible dentro del flujo. |
| **Desde campaña** | Una campaña le envía a ese contacto. |
| **Al cerrar conversación** | Un agente cierra la conversación en el inbox. Trae el caso con el que la cerró — ideal para encuestas de satisfacción. |
| **Cambio de proceso** | El contacto se mueve a otra etapa de un proceso. |
| **Mensaje del cliente en ticket** | El cliente escribe mientras un agente humano ya tiene la conversación. |
| **Mensaje del agente en ticket** | El agente escribe dentro de un ticket abierto. |
| **Subflujo** | Solo arranca cuando otro flujo lo llama. Nunca por sí solo. |
| **Cambio en una base de datos** | Una fila se agrega, se edita o se elimina. |
El nodo de inicio **no se puede eliminar** y sin él no hay flujo.
Los **webhooks** vienen con seguridad incorporada: puedes exigir un token de autenticación y declarar qué datos son obligatorios, de modo que solo tus sistemas autorizados disparen el flujo y siempre llegue con la información completa.
### Cambio en una base de datos
Este inicio dispara el flujo cuando una fila de una base de datos cambia. Sirve para bienvenidas tras un formulario, avisos por cambio de estado o bajas automáticas.
| Ajuste | Para qué sirve |
| - | - |
| **Base de datos** | Qué lista se vigila |
| **Eventos** | Agregar, editar o eliminar |
| **Orígenes** | Formulario, carga manual, API, otro flujo o importación |
| **Columnas** | Solo relevante para ediciones |
| **Columna de destino** | De qué columna sale la persona con la que hablará el flujo |
| **Máximo por minuto** | Tope de ejecuciones por minuto |
Dejar eventos vacíos significa **escuchar los tres**. Dejar orígenes vacíos significa **solo formulario, carga manual y API**.
Las cargas masivas no disparan este inicio, y las cadenas de flujo se cortan al segundo salto para evitar bucles.
### Enviar correo
El paso de **correo** envía un email desde una plantilla y, si activas la espera, puede seguir por caminos distintos según el evento del envío.
| Modo | Salidas |
| - | - |
| **Espera apagada** | Se envió · No se envió |
| **Espera prendida** | Entregado · Rebotó · Lo abrieron · Hicieron click · Se venció la espera · No se envió |
| Variable | Qué trae |
| - | - |
| `{{emailStatus}}` | Qué terminó ocurriendo con el correo |
| `{{emailError}}` | El motivo, cuando no se envió |
| `{{emailMsgId}}` | Identificador del correo |
| `{{emailClickLink}}` | La dirección en la que hicieron click |
«No se envió» existe en ambos modos. Si la cuenta no tiene saldo, el remitente no está verificado o el destinatario está suprimido, el flujo sigue por esa salida.
`{{emailClickLink}}` trae **la URL del enlace**, no el texto del botón. Y el paso **no detecta respuestas** al correo: si la persona contesta, eso no entra por este paso.
## Mensajería
Lo que el cliente ve. La mayor parte de un flujo son estos pasos.
| Paso | Qué hace |
| - | - |
| **Texto** | Envía un mensaje de texto. El caballo de batalla. |
| **Imagen** | Envía una foto, con texto debajo si quieres. |
| **Video** | Envía un video, con texto opcional. |
| **Documento** | Envía un archivo descargable — PDF, hoja de cálculo, factura. |
| **Botones** | Mensaje con botones para tocar. Puede quedarse esperando a que elijan una opción. |
| **Listas** | Un menú desplegable agrupado en secciones, para más opciones de las que caben en botones. |
| **Carrusel** | Varias tarjetas lado a lado, cada una con su imagen y sus botones. |
| **Respuestas rápidas** | Sugerencias cortas que desaparecen cuando tocan una. |
| **Sugerencias** | Sugerencias que la persona puede tocar o ignorar mientras escribe libremente. |
| **Encuesta** | Envía una encuesta y recoge los votos. |
| **Formulario de WhatsApp** | Envía un [formulario nativo](/guides/whatsapp-flows) que la persona llena dentro de WhatsApp. |
| **Ubicación** | Envía un punto en el mapa que tú configuras. |
| **Pedir ubicación** | Le pide a la persona que comparta **su** ubicación y espera. |
| **Contacto** | Envía una tarjeta de contacto que se guarda en un toque. |
| **Plantilla** | Envía una [plantilla aprobada](/guides/templates). Lo único que puede iniciar una conversación o responder fuera de las 24 horas. En el nodo WABA puedes configurar plantillas de autenticación (OTP) y sus opciones de entrega disponibles. |
| **Correo** | Envía un email. Sale del canal de la conversación. |
### Botones: la opción que cambia el flujo
Los botones se comportan distinto según actives o no la **espera de respuesta**:
* **Sin espera**: el mensaje sale y el flujo sigue de largo. Una sola salida.
* **Con espera**: el flujo se detiene y **cada botón tiene su propia salida**. Puedes agregar además una salida para cuando responden algo que no es ninguno de los botones, y otra para cuando se vence el tiempo.
Activa primero la espera de respuesta y conecta los botones después: así cada botón nace con su propio camino y el flujo queda cableado de una sola pasada.
### Repetir un mensaje sobre una lista
Algunos pasos pueden repetirse sobre una variable o una base de datos: en vez de armar diez mensajes, armas uno y se envía por cada elemento.
Puedes usar cualquier campo del elemento dentro del mensaje — incluso como destinatario, para enviarle a cada persona de una lista.
## Esperar y capturar respuestas
| Paso | Qué hace |
| - | - |
| **Esperar respuesta** | Detiene el flujo hasta que la persona conteste, con un tiempo límite. **Este es el paso que captura una respuesta.** |
| **Guardar respuesta** | Guarda en una variable lo último que dijo la persona. **No espera nada.** |
| **Guardar archivo** | Guarda el archivo que enviaron y conserva su enlace. |
| **Formulario por chat** | Pregunta uno por uno los campos de una base de datos y guarda el registro completo. |
| **Esperar** | Pausa antes del siguiente paso. |
**Esperar** es una pausa con reflejos: si la persona escribe antes de que se cumpla el tiempo, el flujo retoma de inmediato en vez de dejarla esperando. Cuando lo que necesitas es una respuesta concreta para seguir, usa **Esperar respuesta**.
En **Esperar respuesta**, elige la variable donde guardar lo que conteste la persona. Ese dato queda disponible para el resto del flujo: para saludarla por su nombre, buscar su pedido o pasárselo a tu equipo con el contexto ya listo.
### Formulario por chat
Es la forma de pedir varios datos sin armar un mensaje por cada pregunta. Eliges una base de datos, se cargan sus campos y por cada uno defines:
* **La pregunta** que se le envía a la persona.
* **El tipo de dato**: texto corto, botón, opciones, fecha, hora, número, correo, enlace, imagen, video — o marcarlo como no obligatorio, ponerle un valor por defecto, o validarlo con una regla propia.
* **El mensaje de reintento** cuando la persona responde otra cosa: *"para continuar, elige una de las opciones"*.
El tipo valida solo. Si un campo es de tipo imagen, el paso verifica que la respuesta sea realmente una imagen antes de aceptarla.
## Decidir el camino
| Paso | Qué hace |
| - | - |
| **Condición** | Ramifica según lo que dijo la persona, un dato del contacto o una expresión propia. |
| **Horario de atención** | Ramifica según el día de la semana y la hora. |
| **Ir a un nodo** | Continúa en otro punto **del mismo flujo**. |
| **Ir a otro flujo** | Entrega la conversación a **otro flujo** y no vuelve. |
| **Fin** | Cierra la ejecución. Toda ruta debe llegar aquí. |
### Condición
Se evalúan en orden y **gana la primera que coincida**. Tres formas de usarla:
1. **Sin IA** — comparación directa contra un dato.
2. **Con IA, positivo o negativo** — la IA interpreta la respuesta y produce dos caminos.
3. **Con IA, por opciones** — tantos caminos como opciones definas.
Comparadores disponibles: igual, distinto, empieza con, contiene, existe, no existe y expresión regular. Para listas: cantidad, primer elemento, último elemento.
Las condiciones trabajan sobre texto y sobre lo que la persona dijo. Para decidir sobre cantidades —montos, plazos, unidades— apóyate en **Transformar con IA**: interpreta el número y devuelve el resultado listo para ramificar.
Ramifica sobre datos que existen en el canal donde corre el flujo. Los datos de contacto de negocio, por ejemplo, los aporta WhatsApp. Elegir el dato correcto para cada canal es lo que hace que cada rama reciba exactamente el tráfico que le toca.
Define el modo de la condición —manual o con IA— antes de cablear sus ramas: al cambiar de modo, las ramas se regeneran con el nuevo criterio de decisión.
### Horario de atención
Ramifica por día y hora: una salida por cada rango que definas, más la de "fuera de horario".
Cuatro detalles para configurarlo con precisión:
| Detalle | Cómo se configura |
| - | - |
| **La hora de fin no se incluye** | Para cubrir hasta las 22:00 en punto, escribe 22:59 |
| **Un rango no puede cruzar la medianoche** | Para 22:00 → 06:00 crea dos rangos |
| **Las horas van con cero adelante** | 09:00, nunca 9:00 |
| **La zona horaria que manda es la de la cuenta** | No la del nodo. Configúrala en los ajustes generales |
### Ir a un nodo vs. ir a otro flujo
Se parecen pero no son lo mismo:
| | Ir a un nodo | Ir a otro flujo |
| - | - | - |
| **A dónde va** | Otro punto del mismo flujo | Un flujo distinto |
| **¿Vuelve?** | Sigue en el mismo flujo | No. Es un traspaso, no una llamada |
| **Las variables** | Se conservan | **No viajan** — solo lo que declares explícitamente |
| **Requisito del destino** | Que ya tenga alguna conexión entrante | Que empiece con un nodo de inicio tipo subflujo |
**Ir a un nodo** es lo que te permite armar menús a los que la persona puede volver las veces que quiera. Cuando saltes hacia atrás, haz que el destino ofrezca siempre una salida —terminar o hablar con una persona— para que la conversación pueda avanzar cuando el cliente ya resolvió lo suyo.
## CRM
Los pasos que conectan la automatización con tu equipo humano.
| Paso | Qué hace |
| - | - |
| **Abrir ticket** | Abre la conversación en el inbox. **Este es el paso que entrega el chat a un humano.** |
| **Asignar área** | Manda un ticket ya abierto a un área. |
| **Asignar agente** | Manda un ticket a una persona específica. |
| **Agregar nota** | Escribe una nota interna en el ticket. El cliente nunca la ve. |
| **Agregar a proceso** | Mete al contacto en un proceso, en la etapa que elijas. |
| **Agregar etiqueta** | Etiqueta al contacto. |
| **Cambiar estado** | Cambia el estado del ticket. |
Reglas de enrutamiento:
* **No puedes asignar un agente sin indicar también el área.**
* **No puedes asignar un agente que no pertenece a esa área.**
* Si indicas solo el área y tu cuenta tiene [asignación automática o balanceada](/guides/crm-configuration), Shimli elige al agente.
Estos pasos también pueden funcionar **con IA**: en vez de que tú definas el área, el agente o las etiquetas, la IA los decide leyendo la conversación. Incluso puede decidir *si* hace falta abrir un ticket.
## Base de datos
| Paso | Qué hace |
| - | - |
| **Insertar** | Guarda un registro nuevo en una de tus [bases de datos](/guides/databases). |
| **Buscar** | Busca con filtros y deja el resultado en una variable. |
| **Actualizar** | Cambia campos de los registros que coincidan. Un valor vacío deja el campo como está. |
| **Eliminar** | Borra los registros que coincidan con los filtros. |
Filtros disponibles: igual, distinto, empieza con, contiene, mayor y menor.
## Tienda
| Paso | Qué hace |
| - | - |
| **Buscar productos** | Busca en el catálogo y deja los resultados en una variable. |
| **Obtener producto** | Trae un producto por su identificador. |
| **Crear pedido** | Crea un pedido. |
| **Actualizar pedido** | Modifica un pedido existente. |
| **Consultar pedido** | Trae un pedido por su identificador — para el clásico "¿dónde está mi pedido?". |
| **Agente de tienda** | Entrega la conversación a un agente que vende y responde sobre el catálogo por su cuenta. |
El **agente de tienda** se configura por sector: comercio electrónico, agendamiento o base de conocimiento. Puede trabajar sobre tu [catálogo de Shimli](/guides/shop-catalog) o sobre un sistema externo, y le defines moneda, horarios, instrucciones y a los cuántos minutos considera abandonado un carrito.
## Inteligencia artificial
| Paso | Qué hace |
| - | - |
| **Agente de IA** | Sostiene la conversación completa, con instrucciones, límites y acciones. Ve a [Agente de IA](/flows/ai-agent). |
| **Transformar con IA** | Una transformación puntual sobre un texto: resumir, traducir, extraer datos, clasificar. No conversa. |
| **Audio o imagen a texto** | Transcribe una nota de voz o describe una imagen que envió la persona. |
| **Leer documento** | Extrae el texto de un documento. |
| **Detectar rostro** | Detecta si hay caras en una imagen. |
| **Comparar rostros** | Compara dos imágenes y dice si son la misma persona, con un porcentaje de similitud que tú defines. |
### Transformar con IA
Es una llamada puntual al modelo con una forma de respuesta definida. Lo útil es que puedes pedirle el resultado **estructurado**:
```
{"nombre": "NOMBRE DEL CLIENTE", "productos": ["TODOS LOS QUE LE INTERESAN"]}
```
Puede trabajar sobre un dato específico que le señales, o sobre los últimos 20 mensajes de la conversación.
## Conectar con otros sistemas
| Paso | Qué hace |
| - | - |
| **Llamada a API** | Llama a un servicio externo y guarda la respuesta en variables. |
| **Ejecutar código** | Corre código Python y devuelve el resultado. |
La **llamada a API** trae dos salidas —respondió y no respondió— para que decidas qué hacer en cada caso. Conecta ambas: la primera sigue con el dato ya traído de tu sistema y la segunda te deja ofrecer una alternativa, como intentar de nuevo o pasar la conversación a tu equipo.
## Tareas programadas
| Paso | Qué hace |
| - | - |
| **Programar evento** | Agenda algo para después, aunque la persona no vuelva a escribir. |
| **Cancelar evento** | Cancela un evento programado antes de que se dispare. |
Sirve para el seguimiento: recordar un carrito abandonado, reactivar a alguien que no contestó, mandar un recordatorio el día antes.
Tres formas de programarlo: una fecha y hora exactas, un intervalo (*"en dos días"*), o unos horarios fijos.
Puedes activar que el flujo **siga de largo** mientras el evento queda agendado. Así continúas la conversación ahora y el recordatorio se dispara después por otro camino.
El paso de **cancelar** mantiene el seguimiento fino: si la persona ya resolvió su asunto, el recordatorio programado se retira y no le llega de más. Puedes cancelar solo los eventos de este flujo, o todos los de esa persona.
## Utilidades
| Paso | Qué hace |
| - | - |
| **Asignar variable** | Escribe un valor en una variable. |
**Asignar variable** puede acumular sobre sí misma, que es su uso más útil:
```
nombreCompleto = {{respuesta}}
nombreCompleto = {{nombreCompleto}} {{respuesta}}
```
Primero el nombre, después le agregas el apellido.
## SMS y llamadas
| Paso | Qué hace |
| - | - |
| **Enviar SMS** | Envía un mensaje de texto, fuera de cualquier canal de chat. |
| **Llamar y leer texto** | Llama y lee un texto con voz sintética. |
| **Llamar y reproducir audio** | Llama y reproduce un audio grabado. |
| **Decir algo en la llamada** | Habla durante una llamada en curso. |
| **Reproducir audio en la llamada** | Reproduce un audio durante una llamada en curso. |
| **Esperar dígitos** | Espera a que marquen números en el teclado — el clásico "marque 1 para ventas". |
| **Esperar voz** | Espera a que la persona hable y captura el audio. |
| **Transferir a un agente** | Pasa la llamada a un humano. Tiene dos salidas: contestaron y no contestaron. |
En los pasos de voz sintética puedes elegir la voz y ajustar su estabilidad, similitud y estilo.
# Autenticación
Source: https://docs.shimli.app/getting-started/authentication
Cómo autenticar tus llamadas a la API de Shimli usando tu token de API.
Shimli usa **autenticación por token**. Cada cliente tiene un token de API único que identifica todas sus llamadas.
## Cómo obtener tu token
1. Inicia sesión en [shimli.app](https://shimli.app).
2. Ve a **Configuración → API**.
3. Tu token aparece ahí. Cópialo.
Trata tu token como una contraseña. Nunca lo expongas en código del lado del cliente que sea público, ni lo subas a repositorios públicos de Git.
## Cómo enviar el token
Hay dos formas de enviar el token. Ambas son equivalentes.
### Opción 1: En el body del request (recomendada)
Incluye el campo `token` dentro del JSON del body:
```json theme={null}
{
"token": "TOKEN_SHIMLI",
"type": "text",
"body": "Hola",
"to": "50499999999",
"instance": "ID_INSTANCE"
}
```
Esta es la forma **más usada** y funciona en todos los endpoints que reciben body.
### Opción 2: Como query parameter
Para endpoints GET (o cuando no puedes enviar body), usa el query param `token` o `api-token`:
```
GET https://api.shimli.app/v1/campaigns?token=TOKEN_SHIMLI&page=1&limit=10
```
```
GET https://api.shimli.app/v1/client?api-token=TOKEN_SHIMLI
```
## Formato del token
El token es una cadena alfanumérica de longitud variable. No tiene un prefijo fijo (como `Bearer` o `sk-`).
## Rotación de tokens
Si tu token se compromete:
1. Ve a **Configuración → API** en el dashboard.
2. Haz clic en **Rotar token**.
3. El token anterior deja de funcionar inmediatamente.
4. Actualiza todas tus integraciones con el nuevo token.
No hay límite en la cantidad de veces que puedes rotar tu token. Te recomendamos rotarlo periódicamente como buena práctica de seguridad.
## Errores de autenticación
Si el token es inválido o falta, recibirás un error:
```json theme={null}
{
"statusCode": 401,
"body": {
"err": true,
"message": "Unauthorized"
}
}
```
Verifica que estás enviando el token correcto y que no tenga espacios en blanco al copiarlo.
# Llamadas y SMS
Source: https://docs.shimli.app/getting-started/calls-sms
Compra números telefónicos en Shimli para hacer y recibir llamadas, enviar SMS y conectar con partners locales como Tigo y Claro.
Además de mensajería digital, Shimli te permite gestionar **llamadas telefónicas** y **SMS** desde la misma plataforma. Puedes comprar números directamente en Shimli o conectar con partners de telefonía.
## SMS
Para enviar SMS necesitas un número telefónico. Tienes dos opciones:
* **Comprar un número en Shimli**: directamente desde la plataforma, sin trámites externos.
* **Conectar con partners locales**: Shimli soporta conexión con **Tigo** y **Claro** en Honduras.
El SMS es útil para notificaciones transaccionales, recordatorios y campañas donde WhatsApp no está disponible para el contacto.
## Llamadas
Shimli soporta llamadas telefónicas de dos formas:
### Llamadas desde WhatsApp
Dentro de la configuración del canal de WhatsApp, en la pestaña **Calling**, puedes activar llamadas de WhatsApp. Esto permite que los clientes te llamen desde la conversación de WhatsApp.
* Activa o desactiva el calling.
* Define si el botón de llamada aparece por defecto.
* Restringe países permitidos.
* Configura la zona horaria.
Las llamadas de WhatsApp tienen restricciones de países soportados. Verifica que tu país esté en la lista antes de activar esta función.
### Llamadas telefónicas (número dedicado)
Puedes comprar un número telefónico en Shimli para:
* **Hacer llamadas** salientes desde la plataforma.
* **Recibir llamadas** entrantes.
* **Reenviar llamadas** a otro número.
Shimli puede trabajar con:
* **SIP** — si tienes una planta telefónica existente, puedes conectarla vía SIP.
* **Número comprado en Shimli** — todo gestionado desde la plataforma.
Cuando compras un número en Shimli, habilitas la función de llamadas y puedes hacer, recibir y reenviar llamadas con ese número.
Tus agentes contestan estas llamadas desde el navegador o desde la [app móvil Shimli Agents](/getting-started/mobile-app), con la pantalla de llamada nativa del teléfono.
## Diferencia entre los tipos de llamada
| Tipo | Cómo funciona | Requisito |
| - | - | - |
| **WhatsApp Calling** | Llamadas dentro de la conversación de WhatsApp | WhatsApp Business API conectado |
| **Número dedicado en Shimli** | Llamadas telefónicas tradicionales | Comprar número en Shimli |
| **SIP** | Conexión con tu planta telefónica existente | Configuración SIP |
Depende. Si quieres conectar vía SIP, puedes usar tu planta telefónica existente. Si prefieres un número nuevo, puedes comprarlo directamente en Shimli sin trámites externos.
Sí. Las llamadas consumen créditos de tu wallet de Shimli. El costo depende del destino y la duración. Los SMS también consumen créditos.
WhatsApp Calling tiene restricciones de países. La lista de países soportados la gestiona Meta y puede cambiar. Revisa la configuración de Calling en tu canal de WhatsApp para ver si tu país está soportado.
# Conectar canales
Source: https://docs.shimli.app/getting-started/connect-channels
Conecta los canales donde la IA de Shimli ejecuta ventas, cobranzas, soporte y operaciones en tiempo real.
Shimli es una plataforma de IA conversacional omnicanal: puedes conectar los canales donde la plataforma ejecuta operaciones reales — WhatsApp, Instagram, Messenger, Live Chat, SMS y llamadas — y gestionarlos desde una sola interfaz. La configuración se hace **100% desde Shimli**, sin conocimientos técnicos.
## Ir a Channels
Desde el sidebar, haz clic en **Channels**. O ve directamente a **[shimli.app/app/channels](https://shimli.app/app/channels)**.
## Canales disponibles
Al entrar, Shimli ya te da **tres canales listos para configurar**:
| Canal | Estado al crear cuenta | Qué hace |
| - | - | - |
| **Live Chat** | Disponible | Widget de chat para tu sitio web |
| **Facebook / Instagram** | Desconectado | Conecta tu Page de Facebook e Instagram |
| **WhatsApp** | Desconectado | Conecta tu WhatsApp Business API |
Además, puedes agregar:
* **Telegram** — conecta un bot de Telegram desde Shimli.
* **SMS** — comprando un número en Shimli o conectando con partners (Tigo, Claro).
* **Llamadas** — números telefónicos para hacer y recibir llamadas desde Shimli.
Cada canal se configura de forma independiente. Puedes empezar por el que necesites y agregar los demás después. No tienes que conectarlos todos al mismo tiempo.
## Guías por canal
Cada canal tiene su propia guía paso a paso:
* [WhatsApp Business](/getting-started/whatsapp-setup) — el canal principal para la mayoría de clientes.
* [Live Chat](/getting-started/live-chat-setup) — widget de chat para tu web.
* [Facebook e Instagram](/getting-started/facebook-instagram) — Messenger e Instagram DM.
* [Telegram](/getting-started/telegram) — bot de Telegram.
* [Llamadas y SMS](/getting-started/calls-sms) — telefonía y SMS.
## Configuración por canal
Una vez conectado un canal, puedes configurarlo desde Shimli sin salir de la plataforma. Cada canal tiene pestañas de configuración:
| Pestaña | Qué se configura |
| - | - |
| **Profile / Customization** | Nombre, descripción, color, ícono, foto de perfil |
| **Icebreakers** | Frases de inicio para romper el hielo |
| **Commands** | Comandos rápidos que el cliente puede usar |
| **Calling** (WhatsApp) | Activar llamadas, países permitidos, zona horaria |
En el caso de WhatsApp, también puedes gestionar el **username** (@handle), solicitar la **verificación de marca** (check azul) y configurar la foto de perfil, todo desde Shimli.
# Crear tu cuenta de Shimli
Source: https://docs.shimli.app/getting-started/create-account
Registra tu cuenta de administrador en Shimli desde cero — desde shimliapp.com hasta la verificación por correo.
Para empezar a usar Shimli necesitas crear una cuenta de **administrador**. Este es el usuario principal con el que gestionarás tu cuenta, tus canales y tu equipo. El proceso toma menos de dos minutos.
## Paso a paso
Entra a **[shimliapp.com](https://www.shimliapp.com/?utm_source=docs\&utm_medium=referral\&utm_content=create-account)**. Esa es la puerta de entrada a Shimli.
En la página principal, haz clic en el botón **Iniciar sesión**. Te lleva a la página de login de Shimli.
Shimli te pregunta si quieres iniciar como:
* **Administrador** — para quienes gestionan la cuenta.
* **Agente** — para miembros del equipo que solo atienden conversaciones.
Si ya tienes usuario y contraseña, ingresas aquí. Si es tu primera vez, ve al siguiente paso.
Debajo del formulario de login, haz clic en el enlace **Crear una nueva cuenta**. Esto te lleva al formulario de registro.
Ingresa:
* **Nombre completo** — tu nombre real (ej: Saddy Madrid).
* **Correo electrónico** — será tu usuario de acceso. Usa un correo que tengas a mano, porque te llegará ahí el enlace de verificación.
* **Contraseña** — elige una contraseña segura.
* **Número de teléfono** — con código de país.
Luego haz clic en **Crear la cuenta**.
Shimli envía un correo electrónico a la dirección que registraste. Abre ese correo y haz clic en **Activar cuenta** y luego en **Verificar cuenta**.
Si no recibes el correo de verificación en unos minutos, revisa tu carpeta de spam o correo no deseado. Sin verificar la cuenta no podrás ingresar.
Una vez verificada la cuenta, vuelve a **[shimli.app/login](https://shimli.app/login)**, ingresa tu correo y contraseña, y ya estarás dentro de tu cuenta de Shimli.
## Enlaces directos
| Enlace | Para qué sirve |
| - | - |
| **[shimliapp.com](https://www.shimliapp.com/?utm_source=docs\&utm_medium=referral\&utm_content=create-account)** | Página principal de Shimli |
| **[shimli.app/login](https://shimli.app/login)** | Iniciar sesión (admin o agente) |
| **[shimli.app/user/auth/create-account](https://shimli.app/user/auth/create-account)** | Crear una cuenta nueva directamente |
El enlace directo de registro ([shimli.app/user/auth/create-account](https://shimli.app/user/auth/create-account)) te lleva al formulario de registro sin pasar por la página principal. Útil si quieres compartirlo con alguien que necesita crear su cuenta rápido.
## Después de crear tu cuenta
Una vez dentro de Shimli, los siguientes pasos son:
1. **Conectar tu WhatsApp Business** — ve a la guía de [configuración de WhatsApp](/getting-started/whatsapp-setup).
2. **Agregar a tu equipo** — ve a [Agregar agentes a tu equipo](/getting-started/create-user) y configura sus [permisos por rol](/guides/user-permissions).
3. **Enviar tu primer mensaje** — sigue el [inicio rápido](/getting-started/first-message).
Sí. Una vez dentro de Shimli, puedes invitar a más personas desde Configuración → Agentes y asignarles permisos de administrador o restringir su acceso por módulo. Ve a [Permisos de usuario](/guides/user-permissions).
No. Puedes crear la cuenta y explorar la plataforma sin tener un número de WhatsApp conectado. La conexión del número se hace después, desde dentro de la plataforma.
No. Crear la cuenta es gratis. Los costos dependen del uso (envío de campañas, templates de WhatsApp, correos) una vez que empiezas a operar.
# Agregar agentes a tu equipo
Source: https://docs.shimli.app/getting-started/create-user
Incorpora a los miembros de tu equipo desde la interfaz de Shimli y configura sus áreas y permisos.
En Shimli, un **agente** es un miembro de tu equipo que atiende conversaciones desde la plataforma. Puedes agregarlo desde la interfaz, sin usar código ni una API.
## Antes de empezar
Ten a mano el nombre completo, número de teléfono y correo electrónico de la persona. El correo se usa como su usuario de acceso. Si tu operación utiliza áreas, decide también a cuáles debe pertenecer.
## Crear un agente desde Shimli
Inicia sesión con una cuenta que tenga acceso a la configuración y ve a **Monitoreo → Agentes**.
Selecciona la opción para crear o agregar un agente y completa su nombre, número de teléfono y correo electrónico.
Asígnale las áreas que correspondan y define los permisos necesarios para su función. Otorga solo el acceso que necesita para trabajar.
Guarda el formulario y confirma que la persona aparezca en la lista de agentes. Para editar después sus áreas, estado o permisos, vuelve a **Monitoreo → Agentes**.
La pantalla de creación es la forma recomendada de agregar manualmente a una persona de tu equipo. Si necesitas sincronizar agentes desde un sistema externo, usa la [API de agentes](/api-reference/agents/insert-agent).
## Configurar áreas y permisos
* En [Configuración del CRM](/guides/crm-configuration#agentes) puedes consultar cómo asignar áreas, editar los datos operativos y revisar la actividad de cada agente.
* En [Permisos de usuario y roles](/guides/user-permissions) puedes ajustar a qué módulos puede acceder cada agente.
## Administrar agentes mediante API
Si estás integrando Shimli con un sistema propio, consulta los endpoints técnicos de la [Referencia API → Agentes](/api-reference/agents/insert-agent):
* [Insert Agent](/api-reference/agents/insert-agent) — crear un agente mediante API.
* [Get Agent](/api-reference/agents/get-agent) — consultar un agente.
* [Delete Agent](/api-reference/agents/delete-agent) — eliminar un agente.
Eliminar un agente redistribuye sus conversaciones asignadas y no se puede deshacer. Revisa el impacto antes de realizar esta acción.
# Conectar Facebook e Instagram
Source: https://docs.shimli.app/getting-started/facebook-instagram
Conecta tu página de Facebook y tu cuenta de Instagram a Shimli para gestionar Messenger e Instagram DM desde un solo inbox.
Shimli te permite conectar tu **página de Facebook** y tu **cuenta de Instagram** para gestionar todos los mensajes de Messenger e Instagram DM desde el mismo inbox unificado.
Facebook e Instagram se conectan en un solo paso. Al autorizar tu cuenta de Facebook, automáticamente quedan conectados Messenger e Instagram.
## Requisito previo
Tu página de Facebook y tu cuenta de Instagram deben estar **interconectadas** (vinculadas). Si ya las tienes vinculadas, el proceso es directo.
## Paso a paso
Desde el sidebar, haz clic en **Channels** y busca el canal de **Facebook / Instagram** (aparece como desconectado).
Al hacer clic, verás la información del canal y un botón para conectarte a través de Facebook.
Haz clic en el botón de conexión. Se abre una ventana de login de Facebook. Ingresa tu usuario y contraseña.
Esto es totalmente seguro. Shimli es partner oficial, así que el proceso es el oficial. Facebook te pregunta qué permisos vas a dar.
Facebook te muestra los permisos que Shimli necesita. Revisa y haz clic en **Siguiente**.
Facebook te pregunta a qué páginas quieres dar permiso. Selecciona las páginas que quieres conectar (ej: la de tu empresa).
Haz clic en **Siguiente** y listo. Con estos pasos ya quedan conectados **Messenger e Instagram**.
## Configurar Facebook e Instagram desde Shimli
Una vez conectado, puedes gestionar la configuración de Messenger e Instagram sin salir de Shimli:
| Pestaña | Qué se configura |
| - | - |
| **Customization / Profile** | Nombre, descripción, ícono |
| **Icebreakers** | Frases de inicio para Messenger e Instagram |
| **Commands** | Comandos rápidos para los usuarios |
Puedes configurar las categorías de Messenger, icebreakers y comandos directamente desde Shimli — no necesitas salir de la plataforma para esto.
Necesitas una **página de Facebook** (business page), no una cuenta personal. Si no tienes una, puedes crearla gratis desde Facebook. La cuenta de Instagram debe estar vinculada a esa página.
Sí. Durante el proceso de autorización, puedes seleccionar a qué páginas dar permiso. Puedes conectar varias y gestionarlas todas desde Shimli.
Sí. Todos los mensajes —de Facebook Messenger, Instagram DM, WhatsApp y los demás canales— se gestionan desde el mismo inbox unificado de Shimli.
# Tu primer mensaje, campaña y encuesta
Source: https://docs.shimli.app/getting-started/first-message
Aprende a iniciar conversaciones, hacer un primer envío y crear tus primeras operaciones desde la interfaz de Shimli, sin programar.
Empieza a operar desde la interfaz de Shimli: envía un mensaje desde Inbox, prepara una campaña para llegar a una lista de contactos o crea una encuesta para conocer la opinión de tus clientes. No necesitas usar la API para estas tareas.
## Envía tu primer mensaje desde Inbox
Antes de comenzar, conecta tu canal de WhatsApp Business siguiendo la guía de [configuración de WhatsApp](/getting-started/whatsapp-setup).
En el menú lateral, selecciona **Inbox** y abre una conversación existente o inicia una nueva con el contacto.
Usa el compositor de mensajes para escribir el texto y, si hace falta, adjuntar una imagen, video, documento o audio.
Presiona **Enviar** y verifica que el mensaje aparezca en el historial. Para iniciar una conversación fuera de la ventana de atención, usa una plantilla aprobada.
Consulta la guía de [envío de mensajes por WhatsApp desde Inbox](/guides/send-whatsapp-message) para los formatos de teléfono, tipos de mensaje y plantillas.
## Crea tu primera campaña
Las campañas permiten contactar a varios clientes usando una base de datos como audiencia.
1. Prepara una [base de datos de contactos](/guides/databases), importando un CSV/Excel o agregando registros desde la plataforma.
2. Si vas a enviar por WhatsApp, crea y consigue la aprobación de una [plantilla](/guides/templates).
3. Sigue los pasos de la guía de [campañas masivas](/guides/campaigns) para seleccionar la audiencia, configurar el contenido y enviar o programar la campaña.
## Crea tu primera encuesta
Para conocer la opinión de tus clientes, abre **Marketing → Polls AI → Crear encuesta**. Define las preguntas, elige la base de datos, y envía o programa la encuesta. Luego podrás consultar las respuestas y analizarlas desde Polls AI.
Sigue la guía de [Polls AI (Encuestas)](/guides/polls-ai) para ver el flujo completo y los tipos de pregunta.
## También puedes enviar tu primer mensaje con código
Si estás integrando Shimli con un sistema propio, usa la API en lugar de la interfaz. La guía [Tu primer mensaje vía API](/api-reference/messaging/first-message) incluye ejemplos y enlaces a los endpoints de WhatsApp, Facebook Messenger y SMS.
# Conectar Live Chat
Source: https://docs.shimli.app/getting-started/live-chat-setup
Configura el widget de chat en vivo de Shimli en tu sitio web — nombre, color, posición, ícono, dominios permitidos y código de inserción.
El **Live Chat** es un canal que Shimli te da desde el momento en que creas tu cuenta. Te permite poner un widget de chat en cualquier sitio web para que los visitantes escriban directamente y sean atendidos por tu equipo o por IA.
El Live Chat ya está disponible al crear tu cuenta — no necesitas conectar nada externo. Solo lo personalizas y pegas el código en tu web.
## Configurar el Live Chat
Desde el sidebar, haz clic en **Channels** y selecciona el canal de **Live Chat**.
En la pestaña **Customization** puedes configurar:
* **Chat Name** — el nombre del widget (máx. 128 caracteres).
* **Chat Description** — una descripción (máx. 512 caracteres).
* **Chat Color** — el color del widget.
* **Chat Position** — dónde aparece la burbuja: esquina inferior izquierda o derecha.
* **Chat Icon** — sube un ícono personalizado.
* **Welcome Message** — el mensaje que ven los visitantes al abrir el chat.
En el campo **Domains**, lista los dominios donde permites que se use el widget. Esto es una medida de seguridad: si alguien copia tu código y lo pega en otro sitio, el widget no cargará.
En la pestaña **Ice Breakers**, define frases de inicio que aparecen cuando un visitante abre el chat por primera vez.
En la pestaña **Commands**, crea comandos rápidos que tus visitantes pueden usar dentro del chat.
Haz clic en el botón **Get Embedded Code** y luego en **Copiar**. Pega ese script en el HTML de tu sitio web — en el `` o antes de cerrar el ``.
## Preview en vivo
Mientras configuras, Shimli muestra un **Live Chat Preview** a la derecha de la pantalla donde puedes ver cómo se ve tu widget con los cambios en tiempo real: posición, color, ícono y mensaje de bienvenida.
## Dónde puedo ponerlo
El widget funciona en **cualquier sitio web** donde puedas pegar el script: WordPress, Shopify, sitios custom, landing pages, etc. Solo asegúrate de que el dominio esté en la lista de dominios permitidos.
Si agregas el widget a un dominio nuevo, no olvides agregarlo a la lista de **Domains** en la configuración. Si no lo haces, el widget no cargará en ese dominio.
No. Solo personalizas el widget desde Shimli, copias el código de inserción y lo pegas en tu sitio web. No necesitas backend ni configuración de servidor.
Sí. Todos los mensajes que entran por el Live Chat se gestionan desde el mismo inbox unificado de Shimli, junto con los de WhatsApp, Facebook, etc.
Sí. Los cambios que hagas en Shimli se reflejan automáticamente en el widget — no necesitas volver a pegar el código en tu web.
# Iniciar sesión en Shimli
Source: https://docs.shimli.app/getting-started/login
Cómo entrar a Shimli como administrador o agente, y qué pasa en tu primer inicio de sesión.
Cuando ya tienes tu cuenta creada, hay dos formas de entrar a Shimli: como **administrador** o como **agente**. Ambas se hacen desde la misma página de login.
## Ir al login
Entra a **[shimli.app/login](https://shimli.app/login)**. Ahí verás dos opciones:
* **Administrador** — para quienes gestionan la cuenta, canales, equipo y configuración.
* **Agente** — para miembros del equipo que atienden conversaciones en el inbox.
Selecciona el tipo de acceso, ingresa tu correo y contraseña, y haz clic en **Iniciar sesión**.
Los agentes pueden entrar con las mismas credenciales desde la [app móvil Shimli Agents](/getting-started/mobile-app), para atender desde el teléfono.
Mientras accedes, el panel lateral de las pantallas de acceso puede mostrar **tarjetas informativas rotativas** con novedades y contenido útil sobre Shimli.
## Tu primer inicio de sesión
La primera vez que entras como administrador, Shimli te hace unas preguntas de onboarding:
1. **Cómo conociste Shimli**
2. **Para qué lo quieres usar**
Estas preguntas no son trámite — sirven para que la IA de Shimli te oriente mejor al momento de sugerir qué crear primero. Responde con honestidad y la plataforma se adaptará a tu caso.
## El dashboard de bienvenida
Después del onboarding, llegas al dashboard. Ahí veras un **checklist de pasos** que te muestra qué falta configurar:
* Si ya conectaste una cuenta de WhatsApp
* Si te falta conectar canales
* Próximos pasos recomendados
## La interfaz de Shimli
### Barra lateral (sidebar)
En el lado izquierdo tienes el menú principal:
| Sección | Para qué sirve |
| - | - |
| **Getting Started** | Checklist de configuración inicial y tutoriales |
| **Monitoreo** | Supervisión en tiempo real de la operación |
| **Flow Builder** | Constructor visual de automatizaciones — ve a [Qué es el Flow Builder](/flows/introduction) |
| **Insights** | Inbox, funnel y métricas |
| **Marketing** | Campañas de WhatsApp, Messenger, voz, SMS, email y encuestas |
| **Shop** | Catálogo de productos |
| **Database** | Bases de datos y listas de contactos |
| **API** | Credenciales para integraciones |
| **Channels** | Conexión y configuración de canales |
| **Settings** | Configuración de la cuenta |
Puedes **expandir o contraer** el sidebar con el ícono del menú para ver los nombres completos o solo los íconos.
### Barra superior
En la parte superior tienes:
* **Wallet / saldo** — tus créditos disponibles para envíos, llamadas y consumo de IA.
* **Agregar créditos** — recarga tu wallet con tarjeta.
* **Preferencia de tema** — cambia entre modo claro (light), oscuro (dark) o automático (system).
* **Menú de usuario** — billing, idioma, enlaces a tutoriales de YouTube y cerrar sesión.
El sidebar se puede expandir para ver los nombres completos de cada sección o contraer para tener más espacio de trabajo.
## Siguiente paso
Ahora que ya estás dentro, el primer lugar que debes visitar es **Channels** para conectar tus canales. Ve a [Conectar canales](/getting-started/connect-channels).
# App móvil para agentes
Source: https://docs.shimli.app/getting-started/mobile-app
Shimli Agents lleva el inbox al teléfono — mensajes, llamadas y notificaciones en tiempo real, donde esté tu equipo.
Tu equipo no siempre está frente a una computadora. **Shimli Agents** es la app móvil para los agentes humanos: el mismo inbox, las mismas conversaciones y las mismas llamadas, en el teléfono y en tiempo real.
Búscala en las tiendas como **Shimli Agents**. Funciona en Android y en iPhone o iPad.
## Qué puede hacer tu equipo desde el teléfono
WhatsApp, Facebook Messenger, Instagram, Telegram y SMS en una sola bandeja, igual que en la versión web.
Cada mensaje nuevo y cada llamada entrante llegan como notificación al teléfono. El agente se entera aunque no tenga la app abierta.
Llamadas de WhatsApp y llamadas telefónicas normales, con la pantalla de llamada nativa del teléfono — se contestan como cualquier otra llamada.
Perfil del contacto e historial completo de la conversación, para responder con contexto sin preguntar dos veces lo mismo.
Cuando un flujo entrega la conversación, el agente la toma desde el teléfono y sigue la atención de forma manual.
## Cómo entra un agente
Desde Google Play o la App Store, buscando **Shimli Agents**.
Con el mismo correo y contraseña que usa en la versión web. Ve a [Agregar agentes a tu equipo](/getting-started/create-user) si el agente aún no tiene su acceso.
El teléfono pide permiso la primera vez. Acéptalo: es lo que hace que los mensajes y las llamadas lleguen al instante.
Cada persona del equipo entra con **su propio usuario**. Así las métricas de atención, los tiempos de respuesta y la satisfacción quedan bien atribuidos a cada agente — ve a [Performance por agente](/guides/crm-dashboard#detalle-de-un-agente).
## La app y la web
Las dos trabajan sobre la misma operación en vivo: lo que se responde en el teléfono aparece en la web al instante, y al revés.
| | App móvil | Versión web |
| - | - | - |
| Atender conversaciones de todos los canales | Sí | Sí |
| Notificaciones push de mensajes y llamadas | Sí | — |
| Contestar llamadas de WhatsApp y telefónicas | Sí | Sí |
| Historial y perfil del contacto | Sí | Sí |
| Configurar canales, flujos y campañas | — | Sí |
| Panel de CRM y métricas | — | Sí |
La app está pensada para **atender**; la configuración de la cuenta —canales, automatizaciones, campañas y permisos— se hace desde la versión web.
No es obligatoria: el inbox web funciona completo desde el navegador. La app suma movilidad y las notificaciones en el teléfono, que es lo que hace la diferencia en tiempos de respuesta cuando el equipo no está sentado frente a la computadora.
Un administrador puede atender conversaciones desde la app, pero la configuración de la cuenta se hace desde la web. Ve a [Iniciar sesión](/getting-started/login) para entender los dos tipos de acceso.
Los envíos y las llamadas se cobran igual que desde la web: lo que cambia es el dispositivo desde el que atiende el agente, no la forma en que se factura.
# Inicio rápido
Source: https://docs.shimli.app/getting-started/quickstart
Pon Shimli a funcionar en minutos: crea tu cuenta, conecta WhatsApp y deja operando la primera automatización con IA.
Esta guía te lleva desde cero hasta dejar Shimli operando en una primera conversación con IA, **todo desde la interfaz** — sin programar ni tocar código.
Entra a **[shimliapp.com](https://www.shimliapp.com/?utm_source=docs\&utm_medium=referral\&utm_content=quickstart)** y haz clic en **Iniciar sesión → Crear una nueva cuenta**. Completa el formulario con tu nombre, correo, contraseña y teléfono. Verifica tu correo y ya estarás dentro.
¿Dudas? Ve la guía detallada de [creación de cuenta](/getting-started/create-account).
Entra a **[shimli.app/login](https://shimli.app/login)**, selecciona **Administrador** e ingresa con tu correo y contraseña. La primera vez, Shimli te hará un par de preguntas de onboarding para entender tu caso de uso.
Más detalle en [Iniciar sesión](/getting-started/login).
Desde el dashboard, ve a **Channels → WhatsApp** en el sidebar y sigue el asistente para conectar tu número de WhatsApp Business API. Esto conecta tu número oficial de empresa con Shimli.
Ve la guía completa de [configuración de WhatsApp](/getting-started/whatsapp-setup).
Ve a **Inbox** en el sidebar. Ahí verás la bandeja de entrada unificada. Para iniciar una conversación nueva:
* Haz clic en el botón de **nueva conversación**.
* Ingresa el número de teléfono con código de país (sin `+`). Ejemplo: `50499999999`.
* Escribe tu mensaje en el campo de texto inferior.
* Presiona enviar.
¡Eso es todo! Tu primer mensaje se ha enviado por WhatsApp Business desde Shimli 🎉
Si el contacto no te ha escrito en las últimas 24 horas, necesitarás usar una **plantilla aprobada** (template) para iniciar la conversación. Crea una desde **CRM → Templates**. Ve la guía de [Plantillas](/guides/templates).
## Lo que viene después
Una vez que ya enviaste tu primer mensaje, esto es lo recomendado:
| Paso | Para qué | Guía |
| - | - | - |
| **Conectar más canales** | Facebook, Instagram, Telegram, Live Chat, SMS | [Conectar canales](/getting-started/connect-channels) |
| **Configurar tu equipo** | Áreas, agentes y permisos | [Configuración del CRM](/guides/crm-configuration) |
| **Importar contactos** | Subir tu base de clientes desde Excel | [Bases de datos](/guides/databases) |
| **Crear una campaña** | Envío masivo con segmentación y métricas | [Campañas masivas](/guides/campaigns) |
| **Automatizar respuestas** | Agentes de IA y flujos conversacionales | [Bandeja de entrada](/guides/inbox) |
## ¿Necesitas integrar con código?
Si quieres conectar Shimli con un sistema externo (CRM propio, formulario web, ERP), Shimli también tiene una API REST. Ve la [Referencia API](/api-reference/messaging/whatsapp-business-api) para ver los endpoints disponibles con ejemplos en cURL, Python, JavaScript y PHP.
# Conectar Telegram
Source: https://docs.shimli.app/getting-started/telegram
Conecta un bot de Telegram a Shimli para recibir y responder mensajes desde el mismo inbox.
Shimli te permite conectar un **bot de Telegram** para recibir y responder mensajes desde el mismo inbox unificado. La conexión es la más sencilla de todos los canales.
## Paso a paso
Abre la app de Telegram (en el teléfono o en desktop) y busca el bot **@BotFather**. Es el bot oficial de Telegram para crear y gestionar bots.
En BotFather, envía el comando `/newbot` para crear un nuevo bot. Sigue las instrucciones:
* Ponle un nombre al bot.
* Ponle un username (debe terminar en `bot`, ej: `MiEmpresaBot`).
* BotFather te responde con un **token** — una cadena de texto larga.
Ve a **Channels** en Shimli, haz clic en el canal de **Telegram** y pega el token que te dio BotFather. Guarda y listo.
Shimli se encarga de toda la conexión con Telegram automáticamente cuando pegas el token. No tienes que configurar nada más.
## Configurar Telegram desde Shimli
Una vez conectado, puedes gestionar Telegram desde Shimli igual que los demás canales:
* **Icebreakers** — frases de inicio.
* **Commands** — comandos rápidos.
No. Cualquier cuenta de Telegram puede crear bots con BotFather. Solo necesitas tener Telegram instalado.
Sí. Cada bot que crees en BotFather genera un token diferente. Puedes agregar varios canales de Telegram en Shimli, cada uno con su token.
No. Tus clientes solo necesitan Telegram. Buscan tu bot por el username que le pusiste y empiezan a chatear.
# Conectar WhatsApp
Source: https://docs.shimli.app/getting-started/whatsapp-setup
Conecta tu WhatsApp Business a Shimli para operar ventas, cobranzas, soporte y automatizaciones con IA.
WhatsApp es uno de los principales canales donde la IA de Shimli ejecuta operaciones reales. La conexión se hace directamente desde Shimli: todo el proceso ocurre dentro de la plataforma, sin que tengas que entrar a consolas externas.
Shimli es partner oficial de Meta, así que el proceso de conexión es el oficial y seguro.
## Paso a paso
Desde el sidebar, haz clic en **Channels**. Busca el canal de **WhatsApp** (aparece como desconectado al principio).
Al hacer clic, verás la información del canal y un botón que dice **Connect with Meta** o **Connect WhatsApp Business**.
Haz clic en **Connect with Meta**. Se abre una ventana de login de Facebook. Ingresa tu usuario y contraseña.
Esto es totalmente seguro. Shimli es partner de Meta, así que el proceso es el oficial. Facebook te pregunta qué permisos vas a dar y tú los autorizas.
Facebook te muestra los permisos que Shimli necesita para gestionar tus mensajes. Revisa y haz clic en **Continuar**.
Elige el **portafolio (Business Portfolio)** al que se conectará WhatsApp.
El portafolio debe estar **verificado**. Un portafolio verificado da mayor confianza y desbloquea más capacidades.
Si ya tienes una cuenta de WhatsApp Business, selecciónala. Si no, crea una nueva desde aquí mismo.
Elige la página de Facebook que se asociará y la cuenta de anuncios. Esto ayuda a tener mejor performance y métricas.
Ponle un nombre y una descripción a tu cuenta de WhatsApp Business.
El nombre debe ser el de tu empresa. Es una cuenta de WhatsApp empresarial, así que el nombre importa para la verificación.
Tienes tres opciones:
* **Número nuevo en la nube**: todo se gestiona desde Shimli, no necesitas un teléfono con ese número.
* **El número que ya usas en la app de WhatsApp Business**: lo conectas y **sigues usando la app** como hasta ahora. Es la opción más común. Ve a [Conectar el número que ya usas](#conectar-el-número-que-ya-usas-en-la-app-de-whatsapp-business).
* **Un número que tienes en WhatsApp normal (no Business)**: primero pásalo a la app de WhatsApp Business, o elimina esa cuenta del teléfono para dejar el número libre.
Se te pide una tarjeta para los cobros de envío de plantillas y mensajes. Agrega tu tarjeta y listo.
Shimli ya completó la migración a la última versión del proceso de conexión. Esto simplifica enormemente el proceso — ya no necesitas trámites manuales para la mayoría de los casos.
## Conectar el número que ya usas en la app de WhatsApp Business
No necesitas un número nuevo ni empezar de cero. **El número que tu negocio ya usa en la app de WhatsApp Business se conecta a Shimli y la app sigue funcionando igual.** Es la forma en que la mayoría de los negocios entra a Shimli: el número que tus clientes ya conocen, el mismo de tus tarjetas y tus anuncios, ahora con automatizaciones, campañas y CRM detrás.
### Qué llega contigo
El historial de tus chats individuales de los últimos meses aparece en el inbox de Shimli, y a partir de ahí se mantiene al día en los dos lados. Tu equipo ve el contexto completo desde el primer día.
La lista de contactos de la app viaja con el número, así que puedes segmentar y hacer campañas sobre la base que ya construiste.
Nombre, foto, descripción y datos del negocio se conservan tal como los tienes.
Sigues atendiendo desde la app si querés, mientras Shimli suma el inbox del equipo, los flujos automáticos y las campañas. Los dos conviven sobre el mismo número.
### Cómo se hace
En el paso del número, indica que vas a conectar el número que ya está en tu app de WhatsApp Business y escríbelo.
En el teléfono te llega un aviso oficial de WhatsApp para conectar tu cuenta a la plataforma. Acéptalo y autoriza que tu historial de chats se comparta.
WhatsApp te envía un código de verificación. Lo escribes en Shimli y el número queda conectado.
Ten la app de **WhatsApp Business** actualizada en el teléfono antes de empezar, y asegúrate de que el número esté en esa app y no en WhatsApp normal. Con eso el proceso toma un par de minutos.
### Cómo se reparte el trabajo
Una vez conectado, cada herramienta hace lo que hace mejor:
| | En la app del teléfono | En Shimli |
| - | - | - |
| **Chats uno a uno** | Sí | Sí, con todo el equipo |
| **Grupos** | Sí, se quedan en la app | — |
| **Campañas y envíos masivos** | — | Sí, sin límite de lista |
| **Automatizaciones y agentes de IA** | — | Sí |
| **CRM, áreas y asignación de agentes** | — | Sí |
| **Métricas del equipo** | — | Sí |
Lo que respondas desde la app sigue siendo gratis y no consume la ventana de 24 horas. Abre la app al menos una vez cada 20 días para que los mensajes se sigan sincronizando en ambos lados.
Algunas funciones personales de la app quedan fuera del número conectado: las **listas de difusión** nuevas (para eso están las campañas de Shimli, que son más potentes), los **mensajes temporales**, los de **una sola vista** y la **ubicación en tiempo real** en chats individuales. Los grupos siguen viviendo en la app.
## Configurar tu WhatsApp desde Shimli
Una vez conectado, puedes gestionar tu cuenta de WhatsApp **sin salir de Shimli**. En la página del canal de WhatsApp verás varias pestañas:
### Profile
Aquí puedes configurar:
* **WhatsApp username (@handle)** — reserva y gestiona tu nombre de usuario para que los clientes te encuentren sin necesidad de tu número.
* **Foto de perfil** — visible en tu perfil de WhatsApp Business.
* **Display name** — el nombre visible (debe estar aprobado).
* **Verificación de marca** — solicita el check azul directamente desde Shimli.
* **Categorías, about, descripción, dirección, email, website** — toda la información del perfil.
Si el username está reservado pero no visible aún, significa que WhatsApp aún no ha activado usernames para todos los usuarios. Shimli lo gestiona automáticamente cuando se habilite.
### Icebreakers
Frases de inicio que aparecen cuando un cliente abre la conversación contigo por primera vez.
### Commands
Comandos rápidos que tus clientes pueden usar dentro de la conversación.
### Calling
WhatsApp permite hacer llamadas desde la conversación. Aquí puedes:
* **Activar o desactivar** el calling.
* Elegir si el botón de llamada aparece **por defecto** o no.
* **Restringir países** — define a qué países se permite llamar.
* Configurar la **zona horaria**.
Las llamadas de WhatsApp tienen restricciones de países soportados. Verifica que tu país esté en la lista antes de activar esta función.
## Ventana de 24 horas
En WhatsApp Business existe la **ventana de servicio al cliente** de 24 horas:
* Cuando un cliente te escribe, tienes 24 horas para responder con mensajes libres (sin costo de plantilla).
* Fuera de esa ventana, necesitas enviar **plantillas aprobadas**.
* Shimli te avisa si intentas enviar un mensaje libre fuera de ventana.
Desde el **1 de octubre de 2026** los mensajes que envías dentro de esa ventana se cobran por mensaje, con 1.000 gratis al mes por cada número. Ve a [Cambios de precios de WhatsApp](/whatsapp/pricing-changes) y calcula tu caso en [Calcular tu costo](/whatsapp/cost-calculator).
No. Puedes conectar el mismo número que ya usas en la app de WhatsApp Business y seguir usando la app — ve a [Conectar el número que ya usas](#conectar-el-número-que-ya-usas-en-la-app-de-whatsapp-business). Si prefieres separar el canal del negocio, también puedes crear un número nuevo en la nube, que se gestiona por completo desde Shimli y no necesita un teléfono.
Los cobros por envío de plantillas y mensajes los gestiona Shimli desde tu wallet. Recarga saldo en la plataforma y Shimli se encarga del resto.
Sí. El número conectado funciona en la app y en Shimli a la vez: tú respondes desde el teléfono cuando quieras y tu equipo trabaja desde el inbox, con el mismo historial en los dos lados. Lo que se queda solo en la app son los grupos.
No. Al conectar el número, tus contactos y el historial de tus chats individuales de los últimos meses se sincronizan con el inbox de Shimli, y tu perfil de empresa se mantiene igual.
Te recomendamos verificar tu portafolio antes de conectar WhatsApp. Un portafolio verificado desbloquea más capacidades y da mayor confianza. Shimli te guía en el proceso.
# Agente de cobros con IA
Source: https://docs.shimli.app/guides/ai-debt-collection
Agente de cobros con IA de Shimli: automatiza negociaciones de pago, entrega links y cierra compromisos desde una base de datos de cartera.
Shimli puede operar un **agente de cobros autónomo** que ejecuta la campaña, sostiene la negociación con cada cliente y **cierra compromisos de pago con link directo** — sin intervención humana.
Caso real documentado: con la cartera vencida de un cliente en un solo archivo Excel, Shimli ejecutó la campaña, sostuvo conversaciones individuales y cerró compromisos de pago — sin integraciones, sin API, sin onboarding técnico.
## Cómo funciona
![Cómo funciona el agente de cobros con IA]()
1. **Subes un Excel** con la cartera vencida (nombre, cuotas, monto, mora).
2. **Shimli lanza la campaña** personalizada 1:1 con los datos de cada contacto.
3. **Cuando el cliente responde, el agente de IA continúa** la conversación con acceso a los datos del Excel y a las políticas de cobro.
4. **El agente cierra compromisos** con fecha, monto y link de pago directo.
## Setup: lo más simple posible
Un único archivo Excel con la cartera vencida. Sin integraciones, sin API, sin onboarding técnico. Shimli lo importa como base de datos.
Selecciona la base de datos, el template de WhatsApp con las variables (nombre, cuotas, monto, mora) y el agente de IA que atenderá las respuestas.
Parametriza montos, intereses, fechas y mensajes que el agente debe respetar.
Establece cuándo el agente debe pasar el caso a un gestor humano (ej: cliente que insiste en no pagar, montos sobre cierto umbral).
La campaña sale masivamente, cada mensaje personalizado con los datos del Excel. Cuando un cliente responde, el agente de IA toma la conversación.
## Capacidades del agente
El agente de cobros con IA demuestra seis capacidades clave:
### 1. Personalización 1:1
Cada mensaje se personaliza con los datos exactos del cliente extraídos del Excel: nombre, número de cuotas vencidas, monto de cada cuota y total en mora. No es una respuesta plantilla — el agente combina los datos con un argumento comercial coherente.
### 2. Comprensión abierta
El agente **entiende lenguaje natural** y responde preguntas que no estaban en el guion. Si el cliente pregunta "¿cuál es el valor de cada cuota?", el agente responde con el dato exacto del Excel y formula una pregunta de cierre.
### 3. Multimodal (texto y voz)
El agente **procesa notas de audio** enviadas por el cliente. En mercados donde WhatsApp se usa mucho con notas de voz, esto es crítico: el agente transcribe, comprende y responde al audio como si fuera texto.
La capacidad multimodal es especialmente importante en Latinoamérica, donde una gran parte de las conversaciones de WhatsApp incluyen notas de voz.
### 4. Resiliencia emocional
El agente mantiene el **tono institucional** incluso ante:
* **Insultos**: no se defiende, valida la emoción y reformula la petición sin ceder posición.
* **Números equivocados**: no acepta el rechazo como cierre. Reconfirma desde los datos del Excel, nombra al titular del crédito y pide amablemente que se le haga llegar el mensaje.
* **Propuestas alternativas**: si el cliente propone una fecha distinta, el agente la acepta, la registra y la confirma con el monto correspondiente.
### 5. Manejo de errores
Los **números equivocados se convierten en oportunidad**, no en pérdida. El agente:
1. No acepta el "número equivocado" como cierre.
2. Reconfirma desde los datos del Excel (nombre del titular).
3. Nombra a la persona registrada en el sistema.
4. Pide amablemente que se le haga llegar el mensaje al titular.
### 6. Cierre comercial
El agente no termina con "un asesor le contactará". **Cierra compromisos reales**:
* **Fecha** del compromiso de pago.
* **Monto** exacto a pagar.
* **Link de pago directo** entregado en el chat.
* **Confirmación explícita** de que el crédito quedará al día en esa fecha.
## Casos de uso reales
| Escenario | Qué hace el agente |
| - | - |
| **El cliente que pregunta** | Responde con datos exactos del Excel, formula argumento comercial y pregunta de cierre |
| **Número equivocado** | Reconfirma datos, nombra al titular, convierte el contacto en puente |
| **Cliente hostil** | Valida la emoción, mantiene tono institucional, aporta contexto, reformula sin culpar |
| **El que negocia** | Acepta la fecha propuesta, registra el compromiso, entrega link de pago |
## Comparativa operativa
| Dimensión | Operación tradicional | Con Shimli |
| - | - | - |
| **Implementación** | Meses · proyecto técnico | Inmediata · un Excel |
| **Equipo requerido** | Gestores telefónicos + supervisores + QA | Cero gestores · supervisión opcional |
| **Capacidad simultánea** | Lineal — 1 gestor, 1 conversación | Paralelismo total · toda la cartera a la vez |
| **Variabilidad de trato** | Depende del estado emocional del gestor | Constante · tono institucional siempre |
| **Cierre de compromisos** | Por llamada · queda en notas | Por chat con link de pago · trazable |
## Métricas de éxito
Para un piloto de cobranza con IA, define estas métricas:
* **Tasa de promesa de pago**: % de contactos que se comprometen a pagar.
* **Cumplimiento**: % de promesas que efectivamente se pagan en la fecha acordada.
* **Recuperación efectiva**: monto recuperado / monto de la cartera enviada.
* **Tasa de escalamiento**: % de conversaciones que pasaron a gestor humano.
No. El piloto funciona con un Excel de la cartera. Para operación continua, puedes conectar tu CRM vía API para sincronizar cartera y pagos en tiempo real.
Sí. El agente es multimodal: procesa notas de audio que el cliente envía por WhatsApp, las transcribe y responde adecuadamente. Esto es crítico en mercados donde el audio es el medio predominante.
El agente mantiene el tono institucional, valida la emoción sin ceder posición y reformula la petición. Si el comportamiento persiste más allá del umbral definido, escala el caso a un gestor humano.
El agente cierra el compromiso con la fecha y monto acordados, y entrega directamente en el chat un link de pago (ej: short link de Shimli) que dirige al cliente a la pasarela de pago.
# Campañas masivas
Source: https://docs.shimli.app/guides/campaigns
Campañas de Shimli: activación masiva con segmentación, programación inteligente y continuación conversacional por IA.
Las campañas de Shimli activan operaciones masivas sobre tus audiencias: lanzan la primera interacción por WhatsApp, SMS o correo y, desde ahí, la IA puede continuar la conversación, calificar, vender o entregar al equipo humano.
![Listado de campañas en Shimli]()
## Requisitos previos
Antes de crear una campaña necesitas:
La lista de contactos a la que enviarás la campaña. Se crea desde [Database](/guides/databases). Debe incluir una columna de teléfono con código de país, sin espacios ni caracteres especiales.
El mensaje que enviarás. Se crea desde CRM → Templates y pasa por aprobación de Meta (2-24 horas). Cada template tiene un costo por envío.
El envío de plantillas tiene un costo. Verifica que tengas saldo en tu wallet de Shimli o método de pago configurado.
**Cada template enviado tiene un costo.** Si envías a 100 contactos, Meta cobra el valor del template × 100. El costo varía por categoría (marketing es más caro que utility) y por país.
## Crear una campaña
![Asistente de creación de campaña]()
Ve a **Marketing → Campaigns → Crear campaña**. Ponle nombre y descripción. Selecciona el canal: WhatsApp Business, SMS o correo.
Selecciona la base de datos/lista de contactos. Luego:
* **Columna de teléfono**: Shimli detecta automáticamente si hay una columna `teléfono` o `phone`. Si tiene otro nombre, selecciónala manualmente.
* **Instancia**: el número de WhatsApp por el que se enviará. Debe ser la misma instancia con la que se creó el template.
* **Segmentación** (opcional): filtra la lista por campos. Ejemplo: enviar solo a contactos donde `marca = LaCuracao`.
* **Rango** (opcional): enviar solo a los primeros N contactos.
Elige el tipo de campaña:
* **Campaña estática**: envía uno o más templates a la lista. Las respuestas se asignan a un agente humano o pasan por automatización.
* **Campaña con flujo**: está ligada a una automatización del [Flow Builder](/flows/introduction). Cuando alguien responde, se activa un flujo conversacional interactivo.
Selecciona el template aprobado, sube la imagen/video si lleva, y mapea las variables a los campos de la base de datos.
* **Enviar ahora**: la campaña sale inmediatamente.
* **Programar**: selecciona zona horaria, fecha y hora.
* **Hora óptima (IA)**: Shimli puede determinar la mejor hora para enviar a cada contacto.
![Contenido y plantillas de la campaña]()
![Programación de la campaña]()
## Segmentación
La segmentación te permite filtrar a qué contactos de la base de datos se les envía la campaña.
* **Por campo**: compara cualquier columna de la base de datos. Ejemplo: `usuario = L.Aguilar` o `cadena = LaCuracao`.
* **Múltiples filtros**: puedes combinar filtros (AND).
* **Rango de mensajes**: enviar solo a los primeros N contactos de la lista.
Los valores de comparación deben estar escritos **exactamente igual** que en la base de datos. Si el Excel tiene "L.Aguilar" con mayúscula, el filtro debe tener "L.Aguilar" también. No reconoce variantes.
## Variables en templates
Los templates pueden incluir variables (`{{1}}`, `{{2}}`) que se rellenan dinámicamente con datos de la base de datos:
* La variable `{{1}}` se puede mapear al campo `name` → cada contacto recibe "Hola, Luis", "Hola, Juan", etc.
* Puedes tener múltiples variables mapeadas a diferentes campos.
* Las variables disponibles dependen de las columnas de la base de datos seleccionada.
## Métricas en tiempo real
Una vez enviada la campaña, Shimli muestra:
| Métrica | Descripción |
| - | - |
| **Enviados** | Cantidad de mensajes enviados |
| **Entregados** | Llegaron al destinatario |
| **Leídos** | Fueron abiertos (depende de si el cliente tiene confirmación de lectura activada) |
| **Rebotados** | No se pudieron entregar |
| **Pendientes** | Aún en cola de envío |
| **Costo estimado** | Aproximación del costo de Meta |
### Vista de embudo
Las métricas se presentan como un **embudo** que te muestra la caída en cada etapa. Por ejemplo, una campaña típica puede verse así:
```
1,045 contactos ──▶ 983 entregados ──▶ 630 leídos
```
Esto te permite ver de un vistazo:
* Cuántos contactos no recibieron el mensaje (entregados vs. enviados).
* Cuántos lo leyeron realmente (leídos vs. entregados).
La tasa de lectura puede ser mayor de lo que se reporta, porque muchos usuarios tienen la confirmación de lectura desactivada (el double check azul). Shimli no puede detectar si leyeron el mensaje en esos casos.
### Motivos de rechazo
Shimli te muestra **por qué** cada mensaje no se entregó, con el motivo exacto que entrega Meta:
* El mensaje fue imposible de entregar.
* El número de teléfono es incorrecto.
* El usuario es parte de un experimento de Meta.
* El usuario tiene el teléfono apagado o sin cobertura.
* Otros motivos técnicos reportados por Meta.
Conocer el motivo exacto de cada rechazo te permite limpiar tu base de datos (eliminar números inválidos) y entender qué contactos vale la pena reintentar.
### Asistente de IA para análisis
El asistente de IA de la campaña te permite:
* **Preguntar en lenguaje natural**: "¿cuántos contactos no abrieron el mensaje?"
* **Exportar segmentos**: "expórtame todos los contactos que no fueron rechazados" o "los que abrieron pero no respondieron".
* **Analizar patrones**: "¿qué día de la semana tuvo mejor tasa de apertura?"
## Exportar resultados
Puedes exportar el detalle de la campaña para ver:
* Quién recibió el mensaje
* A quién le rebotó
* Estado de cada contacto
## Acciones sobre campañas existentes
* **Clonar**: duplica toda la configuración de una campaña existente.
* **Eliminar**: borra la campaña.
* **Ver estadísticas**: accede a las métricas detalladas.
No en una sola campaña. Crea campañas separadas por canal. SMS tiene su propio costo gestionado por la compañía telefónica conectada.
Sí. Puedes agregar 2 o más templates que se enviarán en secuencia. Ten en cuenta que Meta cobra cada template por separado.
# Configuración del CRM
Source: https://docs.shimli.app/guides/crm-configuration
Configura áreas, agentes, casos, procesos, respuestas rápidas y ajustes generales del CRM de Shimli.
La configuración del CRM es lo que le da estructura a tu operación. Desde aquí defines cómo se organizan tus equipos, cómo se asignan las conversaciones, cómo se cierran y cómo se automatizan los seguimientos.
## Áreas (equipos de trabajo)
Las **áreas** son equipos de trabajo que agrupan agentes y conversaciones. Se crean desde **Monitoreo → Áreas**.
Ponle un nombre y una descripción. Define si está activa o inactiva.
Ejemplos de áreas en un retail:
* **SAC** (servicio al cliente)
* **Compras**
* **Devoluciones**
* **Posventa**
Las áreas separan el acceso: si una conversación está en el área de cobros, los agentes de otras áreas no pueden verla — solo si se les transfiere.
## Agentes
Los **agentes** son los miembros humanos de tu equipo que atienden conversaciones. Se crean desde **Monitoreo → Agentes**.
### Crear un agente
Para cada agente necesitas:
* **Nombre** completo
* **Número de teléfono**
* **Correo electrónico** (será su usuario de acceso)
* **Áreas** a las que pertenece
Un agente puede estar en **varias áreas** al mismo tiempo. Por ejemplo, Juan Pablo puede estar en SAC y en devoluciones. Esto fortalece tu equipo porque puedes tener personas cubriendo múltiples funciones.
### Asignar áreas
Al crear o editar un agente puedes asignarlo a una o varias áreas. El selector incluye un **buscador** y muestra el **catálogo completo de áreas**, para encontrar más rápido el equipo correcto incluso cuando tu operación tiene muchas.
### Editar un agente
Al volver a abrir un agente para editarlo, ten presente estas reglas:
* El **correo electrónico** se define al crear el agente y luego **ya no se edita** desde esta pantalla.
* El **estado** que ves en la edición coincide con el estado real del agente.
* El estado del agente se maneja con dos opciones: **Activo** e **Inactivo**.
Si necesitas cambiar el acceso operativo de una persona, revisa su estado y sus áreas asignadas. Eso define si participa activamente en la operación.
### Permisos por agente
Además de contestar el inbox, puedes darle a cada agente permisos para:
* Enviar campañas
* Aplicar encuestas
* Crear email marketing
* Gestionar productos
* Acceder a bases de datos
### Super Agent
El **Super Agent** es un rol especial. Los agentes normales solo ven las áreas a las que están asignados. El Super Agent puede **acceder a todas las áreas** como un administrador, viendo lo que hace cada equipo.
Si tienes un supervisor que necesita ver todas las áreas pero no quieres que reciba conversaciones, marca el Super Agent y activa **Don't receive chat**. Así podrá supervisar sin que se le asignen conversaciones.
### Métricas por agente
Desde la lista de agentes puedes ver en tiempo real:
* Si está **conectado** o no.
* **Conversaciones abiertas y cerradas** en el periodo.
* **Tiempo promedio de contestación**.
* **Interacciones y mensajes**.
* **Eficiencia**.
* **Estado** del agente: activo o inactivo.
Al hacer clic en **Ver** un agente, accedes al detalle completo: cada conversación, quién y por qué la cerró, desde cuándo está abierta, qué canal usa, y el desglose de sus cierres por caso. Puedes exportar el reporte resumido o detallado.
El detalle de cada agente está explicado a fondo en [CRM y Dashboard](/guides/crm-dashboard#detalle-de-un-agente), incluyendo por qué cada persona necesita su propio usuario para que las métricas individuales sirvan.
## Casos
Los **casos** categorizan cómo terminó una conversación al cerrarse. Se crean desde **Monitoreo → Casos**.
Ejemplos de casos:
* Venta generada
* Conversación abandonada
* Solo solicitó información
* Soporte resuelto
Los casos en Shimli hacen más que etiquetar:
* **Asignación por IA**: la IA puede leer la conversación y asignar el caso automáticamente al cerrar.
* **Encuestas automáticas**: puedes ligar un caso a una encuesta. Al cerrar con ese caso, Shimli envía la encuesta automáticamente.
* **Triggers de flujo**: al cerrar con un caso determinado, se puede disparar un workflow que lleva la conversación a otro proceso o agente.
## Procesos
Los **procesos** son las etapas por las que pasa una conversación o lead. Se crean desde **Monitoreo → Procesos**.
Ejemplo en cobranza:
1. **30 días de mora** → 2. **90 días de mora** → 3. **Legal**
Cada vez que cambias un proceso, puedes habilitar **triggers** que automáticamente aplican una encuesta, llevan la conversación a un agente, o disparan un workflow.
**Procesos vs Casos**: los procesos son lo que sucede *durante* la conversación (etapas). Los casos son lo que se asigna *al cerrar* la conversación (motivo de cierre).
Los procesos también alimentan la vista de **funnel**, donde puedes ver en qué etapa están tus conversaciones y detectar cuellos de botella.
## Respuestas rápidas (Quick Answers)
Las **respuestas rápidas** son mensajes pre-guardados que los agentes usan para responder más rápido. Se gestionan desde **CRM → Quick Answers**.
### Quién las crea
* **Administrador**: las respuestas rápidas que crea el admin están disponibles para **todos los agentes**.
* **Agente individual**: cada agente puede crear sus propias respuestas rápidas. Estas **solo las ve él**, no las ven los demás agentes.
### Qué pueden contener
Las respuestas rápidas no son solo texto. Pueden incluir:
* **Archivos adjuntos**: imágenes, videos, documentos (más de uno).
* **Carruseles de productos**: envía automáticamente productos del catálogo con foto, descripción y precio — individual o en carrusel.
* **Carruseles de mensajes**: crea carruseles personalizados sin necesidad de que sean de producto.
* **WhatsApp Flows**: envía un formulario de WhatsApp que se abre dentro del chat.
Las respuestas rápidas con productos se conectan automáticamente con tu catálogo de Shop. El agente no tiene que buscar la foto ni el precio — Shimli lo arma todo.
## Settings (ajustes generales)
Desde **Settings** configuras cómo trabaja toda la plataforma. Se accede desde el sidebar.
### General
| Configuración | Qué hace |
| - | - |
| **Área default** | A qué área van las conversaciones que no tienen una asignación específica (cuando no hay IA ni flow previo) |
| **Modo de asignación** | Cómo se reparten las conversaciones entre agentes (ver abajo) |
| **Zona horaria** | Define tu zona horaria para un mejor control de horas y métricas |
#### Modos de asignación
| Modo | Cómo funciona |
| - | - |
| **Manual** | Cada agente debe ir a "No asignados" y tomar la conversación manualmente |
| **Automático (random)** | Asigna conversaciones de manera aleatoria entre los agentes |
| **Balanceada** | Distribuye las conversaciones equilibrando la carga entre todo el equipo |
### Agent availability
Por defecto viene **activo**. Esto significa que **siempre se asignan conversaciones a los agentes**, incluso si no están conectados o se marcaron como ausentes.
Algunas empresas prefieren que solo se asignen conversaciones a agentes conectados. Si es tu caso, desactiva esta opción para que las conversaciones solo carguen a los agentes que están habilitados en ese momento.
### Budget (presupuesto por agente)
Puedes darle a cada agente un **presupuesto específico** para campañas. Cuando el agente hace envíos, se respetan los límites de ese presupuesto.
### Notificaciones
Configura qué notificaciones reciben los agentes:
* Nueva conversación
* Conversación asignada
* Conversación cerrada
* Cambio de estatus
### Inteligencia artificial
Habilita la IA para tu equipo en el inbox. Los agentes pueden usar IA para:
* Contestar y redactar respuestas.
* Cerrar casos y leads.
Puedes darle un **contexto de tu empresa** y un **lenguaje específico** para que la IA trabaje en tono con tu marca.
### Chat y Flows
Si quieres que cuando una persona escriba a WhatsApp se inicie automáticamente un **flow** (chatbot, agente de IA o workflow preestablecido), habilita esta opción. Es el trigger que conecta el mensaje entrante con tu automatización.
El **área** es el equipo de trabajo que atiende la conversación (ej: cobros). El **proceso** es la etapa en la que está la conversación dentro de ese área (ej: 30 días de mora). Una conversación pertenece a un área y pasa por varios procesos.
Sí. Crea al agente, márcalo como **Super Agent** y activa **Don't receive chat**. Así podrá ver todas las áreas como un administrador, pero no se le asignarán conversaciones.
Sí. Las que crea el administrador son globales. Las que crea cada agente son privadas — solo las ve ese agente.
Las conversaciones solo se asignarán a agentes que estén conectados y disponibles en ese momento. Si nadie está conectado, las conversaciones quedan en "No asignados" hasta que alguien ingrese.
# CRM y Dashboard
Source: https://docs.shimli.app/guides/crm-dashboard
Dashboard de Shimli para medir desempeño operativo, handoff entre IA y humanos, y eficiencia del equipo.
El dashboard de Shimli mide el desempeño operativo de la plataforma: cuánto resuelve la IA, cuánto toma el equipo humano y con qué nivel de eficiencia. Se accede desde **Monitoreo** en el sidebar.
## Dashboard
El dashboard muestra métricas en tiempo real, filtrables por rango de fechas. Cada métrica viene **potenciada por IA**: al pasar el cursor sobre el ícono de estrellita, la IA te explica qué significa esa gráfica y te da recomendaciones.
### Métricas principales
| Métrica | Qué mide |
| - | - |
| **Total de leads atendidos** | Cuántos leads únicos se atendieron en el periodo |
| **Total de conversaciones** | Cuántas conversaciones se gestionaron |
| **Nuevas, abiertas y cerradas** | Distribución por estado |
| **Eficiencia del equipo** | Promedio de respuesta y promedio de cierre (de inicio a fin) |
| **Conversaciones vs mensajes** | Volumen de conversaciones y mensajes en el tiempo |
| **Distribución por IA / humano / handoff** | Cuántas conversaciones atendió la IA, cuántas pasaron a humano (handoff) y cuántas fueron solo humano |
| **Canales más utilizados** | WhatsApp, Facebook, Instagram — qué canal recibe más volumen |
| **Nuevos vs recurrentes** | Cuántos contactos son nuevos vs recurrentes respecto al periodo anterior |
| **Hora pico** | A qué hora te escriben más |
Las recomendaciones de IA toman en cuenta el rango de fechas seleccionado. Si cambias el rango, las recomendaciones se actualizan.
### Performance por agente
Una tabla muestra el desempeño individual de cada agente:
* **Conectado o no** — si el agente está activo en este momento.
* **Conversaciones abiertas y cerradas** en el periodo seleccionado.
* **Tiempo promedio de contestación**.
* **Interacciones** — ciclos de ida y vuelta en una conversación.
* **Mensajes** — cantidad total de mensajes enviados.
* **Eficiencia** — si los cierres fueron satisfactorios o no.
**Interacciones vs mensajes**: no es lo mismo. Una conversación puede tener 10 interacciones (ciclos de pregunta-respuesta) y más de 40 mensajes. Las interacciones miden los ciclos; los mensajes, el volumen total.
### Detalle de un agente
Al hacer clic en **Ver** un agente entras a su detalle completo. Aquí es donde realmente entiendes cómo trabaja esa persona, no solo cuánto trabaja.
**Por qué cierra las conversaciones.** Del total que cerró en el periodo, ves la distribución por caso: cuántas fueron venta, cuántas solo información, cuántas quedaron abandonadas. Es la diferencia entre saber que alguien cerró 726 conversaciones y saber que 701 de esas fueron gente queriendo comprar.
**Cuántos cierres fueron satisfactorios.** Del mismo total, cuántos terminaron bien y cuántos no.
**El listado conversación por conversación**, donde ves de cada una:
* Si está abierta o cerrada, y desde cuándo.
* **Quién** la cerró y **por qué** (el caso asignado).
* Por qué canal entró.
Esta lectura por caso es la que te dice si un agente está donde debe estar. Si alguien tiene mucho volumen pero casi todo es "solo información", quizá está resolviendo consultas que un flujo automatizado podría atender — y su tiempo rinde más en las conversaciones de venta.
#### Exportar el reporte
Puedes exportar la información de un agente en dos formatos:
| Formato | Qué trae |
| - | - |
| **Resumido** | Los totales del agente en el periodo — para un reporte de gestión |
| **Detallado** | Conversación por conversación — para auditar casos puntuales |
La exportación es **por agente**, así que puedes sacar el reporte de una sola persona sin arrastrar al equipo completo.
### Un usuario por persona
Para que estas métricas signifiquen algo, cada persona necesita **su propio usuario**.
Si dos o tres personas entran con el mismo usuario, Shimli no puede distinguirlas: todo lo que hacen se acumula en un solo agente. No hay forma de separar después quién atendió qué — el dato individual simplemente no existe.
Es un caso más común de lo que parece, sobre todo en equipos que rotan turnos con una cuenta compartida. Si te interesa medir rendimiento individual, dividir esos usuarios es el primer paso: sin eso, ninguna de las métricas de esta página sirve para evaluar a una persona.
Agregar agentes puede afectar lo que pagas según tu plan. Escríbenos a [hi@shimli.app](mailto:hi@shimli.app) si necesitas revisar cuántos tienes disponibles.
### Comparación por canal
Si tienes múltiples canales (WhatsApp, Facebook, Instagram), puedes ver cuál recibe más conversaciones y comparar su volumen.
### Casos
Los casos muestran la distribución de motivos de cierre: venta generada, conversación abandonada, solo información, etc. Esto te ayuda a entender qué tipo de interacciones predominan.
Aquí lo ves a nivel de toda la operación. Para ver la misma distribución de **un agente en particular**, entra a su detalle desde [Performance por agente](#detalle-de-un-agente).
## Funnel
La vista de **funnel** muestra visualmente cómo están distribuidas las conversaciones entre procesos, áreas y agentes. Te permite ver cuellos de botella y optimizar el flujo.
Para configurar todo lo que alimenta el CRM — áreas, agentes, casos, procesos, respuestas rápidas y ajustes generales — ve a [Configuración del CRM](/guides/crm-configuration).
# CRM e inyección de leads
Source: https://docs.shimli.app/guides/crm-leads
Cómo gestionar leads y contactos desde la interfaz de Shimli.
Cada conversación en Shimli es un registro de CRM. Desde la interfaz puedes gestionar leads, asignarlos, etiquetarlos y ver el historial completo de cada contacto — sin necesidad de programar.
## Ver y gestionar conversaciones
Desde **Inbox** accedes a todas las conversaciones activas. Cada conversación es un lead o cliente con su ficha completa:
* **Historial completo** de mensajes, llamadas y notas.
* **Tags** personalizables para organizar y filtrar.
* **Asignación** a áreas y agentes específicos.
* **Campos personalizados** con datos del cliente (nombre, email, empresa, etc.).
## Asignación inteligente
Shimli asigna automáticamente las conversaciones según la configuración de tu área:
* **Manual** — tú eliges a qué agente asignar cada conversación.
* **Round-robin** — distribuye equitativamente entre los agentes disponibles del área.
* **Balanceada** — toma en cuenta la carga de trabajo actual de cada agente.
Esto se configura desde **Settings → Áreas**. Ve la guía de [Configuración del CRM](/guides/crm-configuration) para más detalle.
## Etiquetar conversaciones
Los tags te permiten organizar y filtrar conversaciones por temática, prioridad o etapa del proceso de ventas:
* Crea tags personalizados desde la configuración del área.
* Aplica tags desde la ficha de cada conversación.
* Filtra la bandeja de entrada por tags para ver conversaciones específicas.
## Validar números de WhatsApp
Antes de iniciar una conversación nueva, Shimli puede verificar si el número tiene WhatsApp activo. Esto es útil cuando importas bases de datos o creas campañas masivas, para evitar intentos fallidos.
La validación ocurre automáticamente al:
* **Importar contactos** a una base de datos.
* **Crear campañas** — Shimli marca los números inválidos antes de enviar.
* **Iniciar conversaciones** manuales desde la bandeja de entrada.
## Importar leads desde archivos
Puedes cargar leads en lote desde un archivo Excel o CSV directamente en **Databases**. Cada fila se convierte en un contacto con su número, nombre y campos personalizados.
Ve la guía de [Bases de datos](/guides/databases) para más detalle sobre cómo importar y segmentar contactos.
¿Necesitas integrar Shimli con un sistema externo (CRM propio, formulario web, ERP)? Shimli también expone una API para inyectar leads y validar números. Ve la [Referencia API de CRM](/api-reference/messaging/lead-to-crm).
# Bases de datos y listas
Source: https://docs.shimli.app/guides/databases
Bases de datos en Shimli: la información operativa que la IA usa para vender, cobrar, responder y decidir.
Las bases de datos en Shimli son **internas y personalizables**. Son la capa de información que usa la IA y tus automatizaciones para ejecutar operaciones reales. Se usan para:
* **Campañas masivas** de WhatsApp, SMS y correo — la lista de contactos a quién enviar.
* **Automatizaciones** ([Flow Builder](/flows/introduction)) — los agentes de IA pueden leer y escribir datos.
* **Inbox** — los agentes humanos pueden llenar datos durante conversaciones.
* **API** — consumir desde sistemas externos.
![Listado de bases de datos]()
## Crear una base de datos
Hay dos formas de crear una base de datos:
Selecciona la opción de subir archivo.
Shimli detecta automáticamente las columnas y los títulos (headers) de cada una.
Este es el paso más importante. Para cada columna del archivo, defines:
* **Descripción**: el nombre de variable con el que se consumirá el dato (ej: `name`, `phone`, `brand`).
* **Tipo**: texto corto, número, teléfono, imagen, etc.
* **Requerido**: si es obligatorio o no.
El mapeo le dice a Shimli de dónde obtener cada dato. Por ejemplo: "el campo `name` se obtiene de la columna `nombre` del Excel".
La base de datos se crea y los datos se importan. Toma unos minutos.
Selecciona construir manualmente.
Pon un nombre claro y una descripción del propósito de la base de datos.
Para cada campo defines: descripción (nombre de variable), tipo y si es requerido.
La base de datos queda creada vacía. Luego puedes agregar elementos manualmente o importar datos.
![Mapeo de campos al crear una base de datos]()
## Tipos de campo disponibles
| Tipo | Uso |
| - | - |
| **Texto corto** | Nombres, títulos, valores cortos |
| **Texto largo** | Descripciones, notas |
| **Número** | Cantidades, montos, IDs numéricos |
| **Teléfono** | Números de teléfono (con código de país) |
| **Correo electrónico** | Emails |
| **URL** | Enlaces |
| **Fecha** | Fechas sin hora |
| **Fecha y hora** | Timestamps completos |
| **Imagen** | Subir imagen (URL o archivo) |
| **Archivo** | Documentos |
| **Tabla** | Sub-campos anidados (ej: productos con precio mensual y anual) |
El tipo **Tabla** permite crear campos anidados dentro de un campo. Por ejemplo, un campo "producto" que contiene sub-campos "precio\_mensual" y "precio\_anual". Útil para estructuras complejas.
## Gestionar una base de datos
![Configuración de una base de datos]()
Desde la vista de configuración de cada base de datos puedes:
* **Configurar**: ver el contenido y agregar elementos manualmente.
* **Editar estructura**: agregar, eliminar o reordenar campos.
* **Subir desde archivo**: importar datos desde CSV/Excel (respeta la estructura existente).
* **Exportar con filtro**: descargar la base de datos, opcionalmente filtrada por campos.
* **Eliminar todos los datos**: vacía la base de datos pero mantiene la estructura.
* **Publicar formulario**: genera un formulario público que llena la base de datos.
## Formularios públicos
Cada base de datos puede generar un **formulario público** con los campos que definiste. Esto te permite:
* Capturar leads desde una landing page sin programar.
* Compartir un enlace donde los clientes llenan sus datos.
* Los datos entran directamente a la base de datos de Shimli.
El formulario se genera automáticamente a partir de la estructura de la base de datos. Cada campo se convierte en una pregunta del formulario.
Para publicarlo, entra a la base de datos y usa **Publicar formulario**. Shimli te devuelve un enlace que puedes compartir o poner en tu sitio.
### Ponerle la cara de tu marca
El formulario se publica con un diseño genérico. Para dejarlo con tus colores tienes dos caminos:
* **Editar el diseño a mano** — si sabes de código, puedes ajustarlo directamente.
* **Pedírselo a la IA** — sube una imagen de tu marca (tu logo, una pieza gráfica, un pantallazo de tu sitio) y pídele que adapte el formulario a esa identidad. La IA cambia colores, tipografía y estilo por ti.
Puedes seguir pidiéndole ajustes las veces que quieras: *"hazlo más compacto"*, *"cambia el color del botón"*. Adaptar el diseño con IA no tiene costo adicional.
## Consumir la base de datos
Las bases de datos se consumen desde múltiples lugares:
| Donde se consume | Cómo |
| - | - |
| **Campañas masivas** | Seleccionas la BD como lista de envío y mapeas la columna de teléfono |
| **[Flow Builder](/flows/introduction)** | Los pasos de base de datos y los agentes de IA leen y escriben durante las automatizaciones |
| **Inbox** | Los agentes humanos pueden llenar datos del contacto durante la conversación |
| **API** | Endpoints de Contact para leer y escribir vía REST |
## También pueden disparar flujos
Ahora una base de datos también puede **arrancar un flujo** cuando una fila se agrega, se edita o se elimina. Esto la convierte en una fuente operativa, no solo en una lista de contactos.
Casos típicos:
* un formulario crea una fila y arranca la bienvenida,
* un operador cambia una columna a «Aprobado» y se avisa al cliente,
* se elimina un registro y se dispara una baja.
Al configurarlo puedes elegir la base, los eventos, los orígenes, las columnas que importan y la columna de destino. También hay un tope por minuto para evitar saturación.
Las cargas masivas no disparan flujos, y las cadenas entre flujos se cortan al segundo salto para evitar bucles.
## Mapeo de campos en campañas
Cuando usas una base de datos en una campaña, el mapeo de campos es crítico:
* **Columna de teléfono**: Shimli detecta automáticamente si hay una columna llamada `teléfono` o `phone`. Si tiene otro nombre, puedes seleccionarla manualmente.
* **Variables del template**: las variables del template de WhatsApp se rellenan con los campos de la base de datos. Por ejemplo, la variable `{{1}}` se puede mapear al campo `name`.
Los números de teléfono en la base de datos deben incluir el **código de país**, sin espacios ni caracteres especiales. Ejemplo: `50499999999`, no `+504 9999-9999`.
Sí. Las bases de datos de Shimli manejan desde decenas hasta miles de contactos. Para envíos masivos muy grandes, usa la opción de rango para enviar por lotes.
Sí. Usa la [API de Contactos](/api-reference/contacts/insert-contact) para insertar contactos programáticamente, o sube un CSV actualizado que respete la estructura existente.
La base de datos queda vacía pero con todos sus campos intactos. Puedes volver a importar datos en cualquier momento sin tener que recrear la estructura.
# Email Marketing
Source: https://docs.shimli.app/guides/email-marketing
Envía campañas masivas de correo electrónico con remitentes verificados, plantillas creadas con IA, segmentación y métricas tipo embudo.
El módulo de **Email Marketing** de Shimli te permite enviar correos masivos a tus contactos con la misma experiencia que las campañas de WhatsApp: segmentación, programación, variables dinámicas y métricas en tiempo real. Se encuentra en **Marketing → Email Marketing**.
## Cómo funciona
```
Base de datos (con email) ──▶ Remitente verificado ──▶ Plantilla ──▶ Campaña ──▶ Métricas
```
1. **Validas un remitente** (un correo o un dominio).
2. **Creas una plantilla** de correo (con IA o copiando/pegando HTML).
3. **Lanzas una campaña** seleccionando la base de datos, el remitente y la plantilla.
4. **Ves los resultados** en un embudo: enviados, entregados, abiertos, clics.
El correo electrónico funciona como un canal más dentro de Shimli. Puedes cruzarlo con WhatsApp: si un contacto no abre el email en X tiempo, se le envía un WhatsApp automáticamente.
## Remitentes
Antes de enviar cualquier correo, necesitas validar **quién lo envía**. Shimli no puede enviar correos a nombre de un dominio que no hayas autorizado.
Hay dos formas de validar un remitente:
Ve a **Email Marketing → Remitentes → Agregar**. Ingresa el correo desde el que quieres enviar (ej: `sac@tiunza.hn` o `no-reply@tiunza.hn`).
Shimli envía un correo a esa dirección con un enlace de validación.
Al abrir el enlace, el remitente queda verificado y listo para usarse en campañas.
Es la opción más sencilla: no requiere soporte de IT ni cambios en DNS.
Ve a **Email Marketing → Remitentes → Agregar dominio** (ej: `tiunza.hn`). A partir de ese dominio, todos los correos que agregues serán válidos.
Al agregar el dominio, se requiere que tu equipo de IT agregue los registros DNS que Shimli indica (incluye el servidor y otros registros de autenticación).
Una vez configurado el DNS, el dominio queda validado y puedes agregar cualquier correo bajo ese dominio sin verificación individual.
Ideal si planeas enviar desde múltiples direcciones del mismo dominio.
La verificación por dominio requiere intervención de IT para configurar los registros DNS. Coordina con tu equipo antes de iniciar el proceso.
## Plantillas de correo
Las plantillas definen el contenido HTML del correo. Tienes tres formas de crearlas:
### 1. Con el asistente de IA (recomendado)
El asistente de IA construye la plantilla en conversación. No necesitas saber HTML:
1. Describe el correo que quieres: "un correo de promoción de televisores con 10% de descuento".
2. Sube imágenes, un PDF, o incluso un video — el asistente puede tomar cualquiera de estos como insumo para diseñar el correo.
3. La IA genera el correo completo.
4. Pídele ajustes en lenguaje natural: "quítale la parte de arriba", "ponle bordes redondos", "cambia el fondo".
5. La IA itera hasta que te guste.
6. Guarda el resultado como plantilla.
Puedes empezar con un **arte existente** (un JPG, PNG, o el PDF que te pasó tu equipo de diseño) y pedirle al asistente que lo convierta en un correo HTML responsive, agregando las variables dinámicas donde lo necesites.
El asistente conoce el HTML que va generando, así que también puedes pedirle cosas específicas: "agrega la variable de nombre en el título" o "pon el cupo disponible en esta sección". La IA inserta las variables por ti, sin que tengas que tocar el código.
### 2. Copiando y pegando HTML
Si ya tienes el HTML de tu correo (porque lo diseñó tu equipo de arte o lo exportaste de otra herramienta), puedes pegarlo directamente en el editor de plantillas.
### 3. Desde una imagen, PDF o video
Puedes mandar al asistente de IA una imagen del arte, un PDF de diseño, o incluso un video, y pedirle que lo convierta en un correo HTML, agregando las variables dinámicas donde lo necesites.
## Variables dinámicas
Igual que en las plantillas de WhatsApp, los correos pueden incluir **variables** que se rellenan con los datos de la base de datos:
* La variable `nombre` se mapea al campo `name` de tu base de datos → cada contacto recibe "Hola, Luis", "Hola, Juan".
* Puedes usar variables en el **asunto**, en el **texto previo** y dentro del **HTML** del correo.
* En el asunto y texto previo, las variables se insertan fácilmente desde el editor visual.
* Dentro del HTML, el asistente de IA puede insertarlas por ti cuando se lo pidas en lenguaje natural.
## Crear una campaña de email
Ve a **Email Marketing → Campañas → Crear campaña**. Ponle nombre y descripción.
Selecciona la base de datos que contiene los correos de tus contactos. La columna de email debe estar mapeada en la base de datos.
Selecciona uno de tus remitentes verificados. Es la dirección desde la que se enviará el correo.
Filtra la lista por campos, igual que en las campañas de WhatsApp. Ejemplo: enviar solo a contactos donde `cadena = LaCuracao`.
Elige cómo definir el correo:
* Escribir texto directamente.
* Copiar y pegar HTML.
* Traerlo de una plantilla ya creada.
Mapea las variables a los campos de la base de datos.
Envía ahora o programa la campaña.
## Métricas de la campaña
Una vez enviada, Shimli muestra un **embudo** con el detalle de la campaña:
| Métrica | Descripción |
| - | - |
| **Enviados** | Correos enviados a la lista |
| **Entregados** | Llegaron a la bandeja del destinatario |
| **Abiertos** | Fueron abiertos por el contacto |
| **Clics** | El contacto hizo clic en un enlace del correo |
| **Rebotados** | No se pudieron entregar |
| **Rechazados** | No se enviaron (ver motivos abajo) |
### Motivos de rechazo
Shimli te muestra **por qué** un correo no se entregó, con el motivo exacto que entrega el proveedor:
* El mensaje no pudo llegar (imposible de entregar).
* La dirección de correo es incorrecta o no existe.
* El destinatario marcó el correo como spam.
* Problemas de reputación del remitente.
Conocer el motivo exacto de cada rechazo te permite limpiar tu base de datos y mejorar la entregabilidad de futuros envíos.
### Asistente de IA para análisis
El asistente de IA de la campaña te permite:
* Preguntar en lenguaje natural: "¿cómo le fue a esta campaña comparada con la anterior?"
* Exportar segmentos: "expórtame todos los contactos que abrieron pero no hicieron clic".
* Analizar patrones: "¿qué dominios de correo tuvieron más rebotes?"
## Precios
El envío de correos funciona **por envío**, no por contacto:
* Costo base: **\$0.001 USD por correo enviado**.
* Solo pagas lo que envías.
* Entre mayor volumen, se puede negociar un mejor precio.
A diferencia de WhatsApp (donde se cobra por template), el costo del email es directamente proporcional al volumen de envíos. Proyecta tu volumen mensual estimado para negociar mejores tarifas.
## Flujos cruzados email + WhatsApp
Una de las ventajas de tener email y WhatsApp en la misma plataforma es la **automatización cruzada**:
* Si un contacto **no abre** el email en X tiempo → envíale un WhatsApp.
* Si un contacto **hace clic** en un enlace del email → envíale un WhatsApp de seguimiento.
* Si un contacto **responde** al WhatsApp → agrégalo a una lista para el próximo envío de email.
Estos flujos se configuran en el [**Flow Builder**](/flows/introduction) de Shimli, combinando triggers de email con acciones de WhatsApp.
## Dos formas nuevas de enviar correo
### 1. Desde un flujo
Ahora el Flow Builder tiene un paso de **correo** para enviar un email desde una plantilla dentro de una automatización. Puede funcionar con la espera apagada o prendida:
* **Espera apagada**: se envió · no se envió
* **Espera prendida**: entregado · rebotó · lo abrieron · hicieron click · se venció la espera · no se envió
Cuando activas la espera, el flujo puede seguir por caminos distintos según el evento del correo.
Si lo único que quieres es enviar un aviso, apaga la espera. Si lo que viene después depende de si el correo llegó o fue leído, enciéndela.
### 2. Desde la API
También puedes enviar **un solo correo transaccional** desde la API, usando una plantilla guardada y un remitente verificado de la cuenta.
Sirve para:
* confirmaciones de pedido,
* códigos de acceso,
* avisos puntuales,
* comprobantes o notificaciones.
En la práctica, se distingue de una campaña porque no es masiva: es **un correo puntual** disparado por tu sistema o por una integración.
El remitente debe ser **una casilla concreta**, no solo un dominio. Cada envío descuenta saldo, y la lista de supresión también se respeta en este canal.
## Integración con el Inbox
El email también está disponible desde el **Inbox**. Durante una conversación por WhatsApp, un agente puede:
1. El cliente pide: "mándame la cotización por correo".
2. El agente selecciona un remitente ya configurado.
3. Elige o crea una plantilla al vuelo.
4. Envía el correo directamente desde el inbox.
Esto elimina la fricción de cambiar entre herramientas para enviar un correo puntual durante una atención.
Sí. Agrega el dominio en Email Marketing → Remitentes → Agregar dominio. Tu equipo de IT deberá configurar los registros DNS que Shimli indique. Una vez validado, puedes enviar desde cualquier correo bajo ese dominio.
No. El asistente de IA crea la plantilla a partir de una descripción y/o imágenes, y la modifica según tus indicaciones en lenguaje natural. Solo si quieres pegar HTML propio necesitarás tenerlo listo.
Son campañas separadas, pero puedes automatizar el cruce con el Flow Builder. Por ejemplo: envías el email y si no abren en 48 horas, se dispara un WhatsApp con el mismo mensaje.
Por envío, a \$0.001 USD por correo enviado. No hay costo por contacto almacenado. A mayor volumen, se puede negociar un mejor precio de tabla.
# Bandeja de entrada (Inbox)
Source: https://docs.shimli.app/guides/inbox
Inbox operativo de Shimli: el espacio donde el equipo humano recibe, supervisa y toma las conversaciones que atiende la IA.
El inbox es el espacio operativo donde tu equipo humano **supervisa y toma las conversaciones que atiende la IA**. Aquí convergen los mensajes de WhatsApp, Facebook, Instagram, Telegram, SMS, correo y llamadas, y la transición entre agente autónomo y agente humano ocurre con el contexto ya resuelto.
El inbox está diseñado para que los humanos intervengan **solo cuando aportan valor**. La IA atiende; tu equipo supervisa, corrige y cierra.
![Vista general del inbox de Shimli]()
## Estructura de tres columnas
El inbox se divide en tres columnas:
* **Izquierda**: la lista de conversaciones, con filtros, etiquetas y estados.
* **Centro**: la conversación activa, con el historial de mensajes, archivos y eventos.
* **Derecha**: el panel de acciones — agente de IA, llamadas, plantillas, formularios y más.
### Filtros
Los filtros te ayudan a enfocarte en lo urgente. Desde el menú **Filter** de la lista puedes ver:
* **Abiertas**: todas las conversaciones activas
* **No leídas**: solo las que tienen mensajes nuevos sin leer
* **No asignadas**: conversaciones que nadie ha tomado — aquí es donde entras a ayudar
* **Automatizadas**: las que está atendiendo la IA o un flujo en este momento
* **Finalizadas**: las que ya se cerraron
Además, desde la barra superior puedes filtrar por **Áreas** y por **Procesos** para ver solo las conversaciones de un equipo o de un flujo de trabajo específico.
![Filtros del inbox]()
### Acciones rápidas sobre una conversación
Desde el menú de cada conversación en la lista puedes:
* **Marcar como no leída**: útil para volver a ella después sin que se pierda.
* **Fijar conversación**: la mantiene siempre arriba de tu lista.
* **Cerrar**: finaliza la conversación.
![Acciones rápidas de una conversación]()
## La ventana de 24 horas
En WhatsApp y Messenger existe una ventana de 24 horas desde el último mensaje del cliente, durante la cual puedes responder libremente.
Si la ventana está abierta puedes contestar normal. Si la ventana está cerrada, no puedes enviar mensajes libres — tendrías que usar una plantilla aprobada. Shimli te muestra cuántas horas quedan (por ejemplo, "quedan 20 horas").
Desde el **1 de octubre de 2026** las respuestas dentro de esa ventana pasan a cobrarse por mensaje, con 1.000 gratis al mes por cada número. Ve a [Cambios de precios de WhatsApp](/whatsapp/pricing-changes) y a [Calcular tu costo](/whatsapp/cost-calculator).
Más en [Enviar mensaje de WhatsApp](/guides/send-whatsapp-message).
## Acciones dentro de una conversación
### El compositor: mensaje, plantilla, flow o nota
Junto al campo de texto, el selector del compositor te permite cambiar entre cuatro modos:
* **Mensaje**: el texto normal que recibe el cliente.
* **Plantilla**: envía una plantilla aprobada de WhatsApp — necesaria cuando la ventana de 24 horas está cerrada.
* **Flow**: envía un formulario de WhatsApp (Flow) para que el cliente lo complete sin salir del chat.
* **Nota**: un mensaje privado que **solo ve tu equipo**. El cliente nunca lo ve — útil para dejar recordatorios o contexto para otros agentes.
![Modos del compositor]()
Las notas privadas son internas. El cliente nunca las recibe ni las ve.
### Respuestas rápidas
Las respuestas rápidas te ahorran escribir lo mismo una y otra vez. Desde el compositor puedes insertar las que ya existen y también **crear nuevas sobre la marcha**: defines un nombre y un atajo de texto (mínimo 3 caracteres), y la próxima vez la insertas escribiendo el atajo.
![Crear una respuesta rápida]()
Los administradores pueden crear y gestionar respuestas rápidas para todo el equipo desde la configuración del CRM. Más en [Configuración del CRM](/guides/crm-configuration).
### Respuestas con IA
Con la estrellita del compositor, la IA redacta una respuesta por ti con todo el contexto: la conversación, el historial del cliente y tus productos.
Puedes usarla tal cual o pedir variaciones: **repetir** (otra versión), **más corto**, **mejorar la gramática**. Los agentes dicen que les ahorra muchísimo tiempo — la IA redacta y ellos solo revisan y envían.
### Qué más puedes enviar
Desde el compositor no solo envías texto:
* **Nota de voz**: grabas un audio y se envía como nota de voz de WhatsApp.
* **Ubicación**: envías tu ubicación — útil cuando el cliente quiere visitarte.
* **Productos**: seleccionas uno o varios productos de tu catálogo con el buscador y los envías con foto y descripción.
* **Plantillas**: eliges una plantilla aprobada, ves la vista previa y la envías.
* **Formularios**: envías un formulario (Flow) para que el cliente lo complete sin salir de WhatsApp.
![Enviar una plantilla con vista previa]()
![Seleccionar productos para enviar]()
### Programar mensajes, recordatorios y flows
No todo tiene que responderse al momento. Desde el ícono de programar del compositor puedes dejar definido qué pasa después:
Escribes el texto y eliges cuándo enviarlo: **en 1 hora**, **en 3 horas**, **mañana**, **la próxima semana** o una fecha y hora exactas. El mensaje sale solo, aunque no estés conectado.
Dejas un aviso interno que aparece en la conversación a la hora que elijas — por ejemplo, "recordá mandarle la cotización". Ningún seguimiento se te escapa.
Programas la ejecución de un flujo automatizado: eliges el flujo y la hora, y Shimli lo dispara por ti.
Todos los envíos programados quedan listados con su estado, para que veas cuáles ya se ejecutaron y cuáles están pendientes.
![Programar un mensaje]()
![Programar un recordatorio]()
![Programar un flow]()
### Pedir el número de teléfono
Cuando un cliente te escribe por Facebook o Instagram, a veces quieres llevarlo a WhatsApp. Desde las acciones de la conversación, Shimli puede pedirle su número de forma amigable y natural — y él mismo te lo deja.
### Buscar dentro de la conversación
Con el ícono de lupa del encabezado abres la búsqueda dentro de la conversación: escribes y los resultados aparecen al instante. Tiene dos pestañas:
* **Mensajes**: busca en el texto de la conversación.
* **Media**: busca entre las fotos, videos y documentos que se han compartido.
![Buscar dentro de la conversación]()
### Agregar registros a una base de datos
Sin salir de la conversación puedes abrir el panel **Form or Database** y trabajar directo sobre tus bases de datos: elegir la base, ver sus registros (vista **Data**) o el formulario (vista **Form**), y agregar, editar o eliminar registros.
Lo más potente: **Completar con IA**. La IA lee la conversación y llena los campos del registro con los datos que el cliente ya te dio — nombre, teléfono, dirección — para que no tengas que transcribir nada.
![Base de datos desde la conversación]()
Más en [Bases de datos](/guides/databases).
### Información del contacto (tres puntitos)
Al abrir el panel de estado e información de la conversación accedes a:
* **Datos del contacto**: nombre, teléfono, canal de origen, correo, fecha de nacimiento, dirección — y puedes **editarlos** desde ahí mismo.
* **Canal**: WhatsApp, Facebook, Instagram, etc. (cambia el ícono según el canal).
* **Área**: el área asignada — puedes cambiar de área.
* **Agente**: el agente asignado — puedes reasignar.
* **Proceso**: asociar la conversación a un proceso (proceso de ventas, soporte, etc.).
* **Tags**: puedes crear tags rápidos y asignarlos a la conversación.
* **Notas**: lista de notas de la conversación — puedes agregar más.
![Panel de estado e información del contacto]()
### Cerrar conversación
Cuando el tema se resolvió, cierras la conversación. La buena práctica es hacerlo en dos pasos:
Confirma que el cliente quedó satisfecho: "¿Algo más en que te pueda ayudar?"
Haces clic en cerrar. La conversación pasa a finalizadas y tu lista queda limpia.
## Llamadas
Desde una conversación puedes hacer dos tipos de llamada:
* **Llamada de WhatsApp**: sale desde tu número de WhatsApp conectado — el cliente la recibe como una llamada normal de WhatsApp.
* **Llamada regular**: sale por tu planta telefónica.
Al hacer clic en el ícono de llamada eliges cuál usar.
![Elegir el tipo de llamada]()
Después de cada llamada la IA genera automáticamente:
* **Resumen**: de qué se habló, en viñetas claras
* **Transcripción**: cada intervención, con hora
* **Análisis**: duración, resultado de la llamada, seguimientos necesarios, sentimiento del cliente
Esto significa que nadie tiene que tomar notas durante la llamada — la IA lo hace, y mejor.
También puedes hacer llamadas directas y recibir llamadas de tus clientes. Más en [Llamadas y SMS](/getting-started/calls-sms).
## Nueva conversación
¿Quieres escribirle a alguien que no te ha escrito? Haces clic en el **+**, ingresas su número, eliges una plantilla y envías. Así se inician conversaciones proactivas.
## Tomar una conversación automatizada
Si una conversación está en el filtro de **Automatizadas** y quieres que un humano la atienda, entras y haces clic en **Take control** (tomar control). La conversación se vuelve manual y la IA deja de responder hasta que la liberes.
Más sobre cómo funciona el agente de IA en [Agente de IA en el flujo](/flows/ai-agent).
## Preferencias
En las preferencias del inbox puedes definir:
* El idioma (inglés o español).
* Los canales que ves — puedes ocultar canales que no usas.
* Si quieres o no recibir notificaciones de cada evento.
# Live Chat
Source: https://docs.shimli.app/guides/live-chat
Integra chat en vivo en tu sitio web con Shimli.
Shimli incluye un widget de chat en vivo que puedes integrar en tu sitio web. Los visitantes pueden chatear con tu equipo en tiempo real, y las conversaciones se sincronizan con el CRM de Shimli.
## Crear una sesión de chat
Cuando un visitante abre el chat, crea una sesión:
```bash theme={null}
curl -X POST https://api.shimli.app/v1/live-chat/session \
-H "Content-Type: application/json" \
-d '{
"token": "TOKEN_SHIMLI",
"instance": "ID_INSTANCE",
"name": "Visitante Anónimo"
}'
```
El campo `name` es opcional. Si lo omites, la sesión se crea sin nombre.
## Enviar un mensaje
```bash theme={null}
curl -X POST https://api.shimli.app/v1/live-chat/ \
-H "Content-Type: application/json" \
-d '{
"token": "TOKEN_SHIMLI",
"type": "text",
"body": "¡Hola! ¿En qué te puedo ayudar?",
"to": "SESSION_ID",
"instance": "ID_INSTANCE"
}'
```
## Marcar como enviado por el usuario
Por defecto, los mensajes se marcan como enviados por el agente. Si quieres marcar un mensaje como enviado por el visitante (por ejemplo, al recibir un mensaje del widget):
```json theme={null}
{
"token": "TOKEN_SHIMLI",
"type": "text",
"body": "Quiero información sobre el producto X",
"to": "SESSION_ID",
"instance": "ID_INSTANCE",
"user": true
}
```
## Flujo de integración
Cuando el visitante abre tu sitio, crea una sesión con `POST /v1/live-chat/session`.
Recibe los mensajes del servidor y muéstralos en el chat del lado del cliente.
Cuando el visitante escribe, envía el mensaje con `user: true`.
Tu backend recibe los mensajes del agente y los reenvía al widget.
## Referencia
* [Create Live Chat Session](/api-reference/live-chat/create-session)
* [Send Live Chat Message](/api-reference/live-chat/send-message)
# Gestionar contactos
Source: https://docs.shimli.app/guides/manage-contacts
Crea, importa y organiza contactos desde la interfaz de Shimli; usa la API para sincronizarlos con sistemas externos.
En Shimli puedes gestionar contactos desde la interfaz, sin programar. Los registros se organizan en **bases de datos** con campos configurables y se pueden usar en campañas, automatizaciones y conversaciones. También puedes conectarlos con sistemas propios mediante la API.
## Crear y organizar una lista de contactos
Para empezar, crea una base de datos que defina qué información guardarás. Puedes construir su estructura manualmente o importar un archivo CSV/Excel. Consulta la guía de [Bases de datos y listas](/guides/databases#crear-una-base-de-datos) para ver el proceso completo.
## Añadir contactos desde la interfaz
Abre la base de datos que corresponda y usa su vista de configuración para agregar registros manualmente o subir un archivo CSV/Excel. Al importar, revisa que las columnas estén mapeadas a los campos correctos de la base.
Si todavía no tienes una base de datos, créala primero y define sus campos. Puedes agregar registros manualmente después o cargar varios contactos desde un archivo. La guía de [gestión de bases de datos](/guides/databases#gestionar-una-base-de-datos) explica estas opciones.
## Campos de contacto
Cada base de datos puede tener los campos que necesite tu operación, como nombre, teléfono, correo, ciudad o tipo de cliente. Los campos disponibles dependen de la estructura que configures.
Para campañas por WhatsApp, asegúrate de que el registro tenga un número con código de país. En la API se representa como `código de país + número`, sin el signo `+`; por ejemplo, `50499999999`.
## Consultar, exportar y usar los contactos
Desde la vista de la base de datos puedes consultar sus registros, exportarlos (también con filtros) y reutilizarlos en tus operaciones. Por ejemplo, puedes elegir la base como audiencia de una campaña o usar sus datos en un flujo. Consulta [cómo gestionar una base de datos](/guides/databases#gestionar-una-base-de-datos) para las acciones disponibles desde la interfaz.
## Sincronizar contactos mediante API
Si necesitas crear o consultar contactos desde un CRM, ERP, formulario u otro sistema, usa la API de Shimli. Este método requiere integración técnica y un token de API:
* [Insert Contact](/api-reference/contacts/insert-contact) — crear un registro en una lista.
* [Get Contact](/api-reference/contacts/get-contact) — consultar registros de una lista.
Para trabajar desde la plataforma no necesitas usar estos endpoints: puedes crear bases de datos y agregar contactos o importar archivos desde la interfaz.
# Polls AI (Encuestas)
Source: https://docs.shimli.app/guides/polls-ai
Crea encuestas, recopila respuestas y conversa con un asistente de IA que analiza los resultados y te da los insights que importan.
**Polls AI** es el módulo de encuestas de Shimli. Te permite crear encuestas, enviarlas masivamente y analizar los resultados con un asistente de IA conversacional — sin exportar a Excel ni armar gráficas a mano.
Se encuentra en **Marketing → Polls AI**.
![Detalle de una encuesta en Polls AI]()
## Cómo funciona
```
Crear encuesta ──▶ Enviar a lista ──▶ Recopilar respuestas ──▶ Analizar con IA
```
1. **Creas la encuesta** con tus preguntas.
2. **La envías** a una base de datos, igual que una campaña.
3. **Los contactos responden** por WhatsApp.
4. **El asistente de IA analiza** los resultados en lenguaje natural.
## Crear una encuesta
Accede a **Marketing → Polls AI → Crear encuesta**.
Crea las preguntas de la encuesta. Pueden ser:
* **Calificación**: "¿Cómo calificaría su servicio al cliente?" (1-5 o 1-10).
* **Opción múltiple**: "¿Qué producto le interesó más?".
* **Abierta**: "¿Qué mejoraríamos?".
Elige a qué lista de contactos enviar la encuesta.
Envía ahora o programa para una fecha/hora.
## Métricas en tiempo real
Una vez enviada la encuesta, Shimli muestra:
| Métrica | Descripción |
| - | - |
| **Alcance** | Cuántos contactos recibieron la encuesta |
| **Respuestas** | Cuántos respondieron |
| **Tasa de respuesta** | Porcentaje de contactos que respondieron |
| **Detalle por pregunta** | Distribución de respuestas de cada pregunta |
| **Comentarios abiertos** | Texto completo de respuestas abiertas |
Puedes **filtrar por rango de fecha** para ver los resultados de un periodo específico (ej: "ver solo las de mayo").
![Respuestas y distribución por pregunta]()
## Asistente de IA para análisis
La principal ventaja de Polls AI es el **asistente conversacional** que analiza los resultados:
* **Pregunta en lenguaje natural**: "¿Cómo está en general el servicio al cliente según las respuestas de mayo?"
* El asistente revisa cada respuesta y te da un análisis estructurado.
* **Identifica patrones**: "¿Qué porcentaje dijo que sí vs. que no?"
* **Genera insights procesables**: no solo números, sino recomendaciones basadas en lo que respondieron tus contactos.
![Análisis conversacional de resultados con IA]()
En lugar de exportar a Excel y armar tablas dinámicas, conversas con el asistente: "¿qué complaint aparece más?" o "¿hay diferencia entre los que respondieron en la mañana vs. la tarde?". La IA hace el análisis por ti.
## Casos de uso
| Caso | Tipo de encuesta |
| - | - |
| **CSAT (satisfacción)** | Calificación del servicio al cliente después de una atención |
| **NPS** | "¿Recomendaría usted nuestra empresa a un amigo?" |
| **Investigación de mercado** | Preferencias de producto antes de un lanzamiento |
| **Feedback de evento** | Encuesta post-evento a asistentes |
| **Calidad de entrega** | "¿Recibió su pedido en buen estado?" |
## Relación con campañas
Las encuestas funcionan sobre la misma infraestructura que las campañas masivas:
* Usan la misma **base de datos** de contactos.
* Se envían por **WhatsApp** con un template.
* Tienen las mismas opciones de **segmentación** y **programación**.
* Los resultados se ven en el mismo formato de **embudo y métricas**.
Puedes combinar encuestas con campañas: primero envías una campaña de marketing y luego una encuesta de satisfacción a quienes respondieron. Usa la segmentación para dirigir la encuesta solo a ese grupo.
Las encuestas se envían principalmente por WhatsApp, aprovechando los templates y la infraestructura de campañas. El contacto responde directamente en la conversación.
Sí. Además del análisis agregado, puedes ver la respuesta completa de cada contacto, con su nombre y fecha.
Sí. Puedes pedirle al asistente que compare resultados entre meses o entre distintas encuestas para identificar tendencias.
# Enviar mensajes por WhatsApp
Source: https://docs.shimli.app/guides/send-whatsapp-message
Cómo enviar texto, multimedia y mensajes interactivos por WhatsApp Business desde la interfaz de Shimli.
Desde la bandeja de entrada de Shimli puedes enviar y recibir mensajes por WhatsApp Business sin necesidad de programar. Todo se hace desde la interfaz.
## Requisitos previos
* Tener un número de WhatsApp Business conectado a tu cuenta de Shimli. Si aún no lo tienes, ve a [Conectar WhatsApp](/getting-started/whatsapp-setup).
* Un contacto con número de teléfono válido (con código de país, sin `+`).
## Enviar un mensaje desde la bandeja de entrada
Ve a **Inbox** y selecciona el contacto al que quieres escribirle, o inicia una conversación nueva buscando el número en la barra superior.
En el campo de texto inferior, escribe lo que quieras enviar. Puedes usar emojis, menciones y formato básico.
Usa el ícono de clip para adjuntar imagen, video, documento o audio. Los archivos se suben directamente desde tu equipo.
Presiona enviar. El mensaje se entrega por WhatsApp Business y queda registrado en la ficha del contacto.
## Tipos de mensaje soportados
Puedes enviar desde la bandeja de entrada:
* **Texto** — mensajes simples con emojis y formato.
* **Imagen** — con o sin texto acompañante (caption).
* **Video** — con o sin caption.
* **Documento** — PDF, Word, Excel, etc. Se muestra el nombre del archivo.
* **Audio** — notas de voz o clips de audio.
* **Ubicación** — coordenadas que se muestran como pin en el mapa.
Los archivos multimedia que adjuntas desde la interfaz se suben automáticamente a Shimli y se entregan al contacto. No necesitas hospedarlos en un servidor propio.
## Formato del número de teléfono
Cuando inicias una conversación nueva, el número debe incluir:
* **Código de país** (ej: `504` para Honduras, `52` para México, `57` para Colombia)
* **Número de teléfono** sin espacios, guiones ni el signo `+`
| País | Formato correcto | Incorrecto |
| - | - | - |
| Honduras | `50499999999` | `+504 9999-9999` |
| México | `521234567890` | `+52 1 234 567 890` |
| Colombia | `573001234567` | `+57 300 123 4567` |
## Validar si un número tiene WhatsApp
Antes de enviar, Shimli puede verificar si un número tiene WhatsApp activo. Esto evita intentos fallidos y te ayuda a limpiar tu base de contactos.
La validación se realiza desde la plataforma al momento de enviar o importar contactos. Si un número no tiene WhatsApp, Shimli te lo indica.
Recuerda la ventana de 24 horas. Si el cliente no te ha escrito recientemente, necesitas enviar una **plantilla aprobada** en lugar de un mensaje libre.
## Plantillas aprobadas (templates)
Para iniciar conversaciones fuera de la ventana de 24 horas, necesitas usar una plantilla aprobada por Meta. Shimli te guía en la creación y aprobación de plantillas desde **CRM → Templates**.
Ve la guía de [Plantillas](/guides/templates) para más detalle.
### Enviar una plantilla de autenticación (OTP) desde Inbox
Las plantillas **Authentication** también se pueden enviar desde una conversación en Inbox. Antes, crea la plantilla, envíala a aprobación y asegúrate de tener disponible el código vigente que generó tu sistema de autenticación.
Selecciona al contacto que debe recibir el código y confirma que estás usando la instancia de WhatsApp correspondiente a la plantilla.
Elige la plantilla OTP que quieras enviar desde las plantillas disponibles para esa conversación.
Ingresa el código de un solo uso generado por el sistema que autentica al usuario. No uses el número de teléfono, un valor de ejemplo ni el marcador `{{1}}` como código.
Envía el mensaje. El usuario recibirá el código según el método configurado en la plantilla; asegúrate de que tu aplicación valide el código y lo expire en el plazo establecido.
Envía únicamente un OTP real, vigente y destinado a ese usuario. La plantilla entrega el código, pero no lo genera ni lo valida por sí misma.
¿Necesitas integrar con un sistema externo? Shimli también expone una API para enviar mensajes por WhatsApp. Ve la [Referencia API de WhatsApp Business](/api-reference/messaging/whatsapp-business-api).
# Catálogo de productos (Shop)
Source: https://docs.shimli.app/guides/shop-catalog
Gestiona tu catálogo de productos para comercio conversacional con la API de Shop de Shimli.
# Catálogo de productos
Shimli incluye un sistema de catálogo de productos (Shop) que te permite vender por chat. Los productos pueden mostrarse como carruseles deslizables dentro de WhatsApp.
## Crear un producto
```bash theme={null}
curl -X POST "https://api.shimli.app/v1/shop/products/?token=TOKEN_SHIMLI" \
-H "Content-Type: application/json" \
-d '{
"name": "Crédito Personal Express",
"description": "Préstamo personal pre-aprobado en 5 minutos",
"descriptionai": "",
"code": "CRED-PE-001",
"price": 25000.00,
"category": ["préstamos", "personales"]
}'
```
| Campo | Tipo | Descripción |
| - | - | - |
| `name` | string | Nombre del producto |
| `description` | string | Descripción |
| `descriptionai` | string | Descripción generada por IA (opcional) |
| `code` | string | Código interno (opcional) |
| `price` | number | Precio |
| `category` | array | Categorías |
| `image` | string | URL de imagen (al actualizar) |
| `status` | number | 1 = activo, 0 = inactivo |
El campo `descriptionai` permite usar una descripción generada por IA de Shimli. Si lo dejas vacío, Shimli puede generar una automáticamente basada en el nombre y la descripción.
## Obtener un producto
```bash theme={null}
curl "https://api.shimli.app/v1/shop/products/ID_PRODUCT?token=TOKEN_SHIMLI"
```
## Actualizar un producto
```bash theme={null}
curl -X PUT "https://api.shimli.app/v1/shop/products/ID_PRODUCT?token=TOKEN_SHIMLI" \
-H "Content-Type: application/json" \
-d '{
"image": "https://ejemplo.com/producto.jpg",
"name": "Crédito Personal Express 2026",
"description": "Préstamo personal pre-aprobado, tasa especial",
"price": 23000.00,
"category": ["préstamos", "personales", "promoción"],
"status": 1,
"code": "CRED-PE-001"
}'
```
## Eliminar un producto
```bash theme={null}
curl -X DELETE "https://api.shimli.app/v1/shop/products/ID_PRODUCT?token=TOKEN_SHIMLI"
```
## Referencia
* [Get Product](/api-reference/shop/get-product)
* [Create Product](/api-reference/shop/create-product)
* [Update Product](/api-reference/shop/update-product)
* [Delete Product](/api-reference/shop/delete-product)
# Short Links
Source: https://docs.shimli.app/guides/short-links
Crea y gestiona enlaces cortos con tracking integrado.
Shimli incluye un acortador de URLs integrado. Útil para campañas por WhatsApp y SMS donde los enlaces largos se ven feos y quieres trackear clics.
## Crear un short link
```bash theme={null}
curl -X POST https://api.shimli.app/v1/short \
-H "Content-Type: application/json" \
-d '{
"token": "TOKEN_SHIMLI",
"longUrl": "https://mitienda.com/productos/credito-personal-express-2026?utm_source=whatsapp"
}'
```
### Con identificador personalizado
```json theme={null}
{
"token": "TOKEN_SHIMLI",
"longUrl": "https://mitienda.com/promo",
"idUrl": "promo-julio-2026"
}
```
Si especificas `idUrl`, el enlace corto será `sh.li/promo-julio-2026` (o tu dominio corto configurado). Si lo omites, Shimli genera un identificador automático.
## Actualizar el destino de un short link
Puedes cambiar a dónde apunta un short link sin cambiar la URL corta:
```bash theme={null}
curl -X PATCH https://api.shimli.app/v1/short \
-H "Content-Type: application/json" \
-d '{
"idUrl": "ID_SHORT_LINK",
"token": "TOKEN_SHIMLI",
"longUrl": "https://mitienda.com/nueva-promo-agosto"
}'
```
Esto es útil para campañas recurrentes: mantienes el mismo enlace corto en tus plantillas pero actualizas el destino según la promo vigente.
## Casos de uso
* **Campañas por WhatsApp**: enlaces cortos en plantillas para trackear clics
* **SMS**: ahorra caracteres (importante en SMS con límite de 160)
* **QR codes**: short links generan QRs más limpios
* **A/B testing**: un mismo short link que actualizas a diferentes destinos
## Referencia
* [Create Short Link](/api-reference/short-links/create)
* [Update Short Link](/api-reference/short-links/update)
# Templates de WhatsApp
Source: https://docs.shimli.app/guides/templates
Plantillas de WhatsApp en Shimli: crea mensajes aprobados por Meta y escríbelos con IA para iniciar operaciones masivas.
Los **templates** son mensajes preaprobados por Meta que Shimli usa para iniciar operaciones masivas por WhatsApp fuera de la ventana de 24 horas: campañas, seguimiento, cobranza o activación comercial.
## Cuándo necesitas un template
* Para **iniciar una conversación** con un cliente que no te ha escrito recientemente.
* Para **campañas masivas** de marketing.
* Para **continuar una conversación** que pasó las 24 horas.
Dentro de la ventana de 24 horas (después de que el cliente te escribe), puedes responder libremente sin template. El template solo es necesario para iniciar o reabrir conversaciones. Desde el **1 de octubre de 2026** esas respuestas libres pasan a cobrarse, con 1.000 gratis por número cada mes: ve a [Cambios de precios de WhatsApp](/whatsapp/pricing-changes).
## Categorías de Meta
| Categoría | Uso | Costo |
| - | - | - |
| **Marketing** | Promociones, cupones, invitaciones, ofertas | Más elevado |
| **Utility** | Confirmaciones, recordatorios, notificaciones transaccionales | Más económico |
| **Authentication** | Códigos de verificación de un solo uso (OTP) para login o transacciones | Tarifa específica de autenticación |
Si creas un template como **utility** pero Meta detecta que es **marketing**, puedes recibir un **strike**. A cierta cantidad de strikes, tu número puede ser bloqueado. Usa la categoría correcta. Las plantillas de **authentication** tienen reglas estructurales estrictas y no admiten contenido promocional.
## Crear un template con IA
No necesitas redactarla tú. En el constructor de plantillas tienes la opción de **generar con IA**: le describes en tus palabras para qué la quieres y Shimli la escribe completa.
Elige la opción de generar con inteligencia artificial.
Escríbelo en lenguaje normal. Por ejemplo: *"Se me pasó la ventana de 24 horas y quiero retomar la conversación con un cliente que dejó una consulta sin responder."*
También puedes adjuntar imágenes o documentos para que la plantilla los incluya.
La IA redacta el mensaje, propone los botones y arma los ejemplos de variables que Meta exige.
Puedes editar cualquier parte del texto generado antes de enviarla. Si una frase no suena a tu marca — por ejemplo un *"lamentamos la demora"* que hace ver que fallaste — la cambias ahí mismo.
Desde ahí sigue el mismo camino que una plantilla escrita a mano: Meta la revisa y te avisa.
Generar la plantilla con IA **no tiene costo adicional**: está incluido en Shimli. Lo que sí se cobra es el envío de la plantilla, y eso lo cobra Meta directamente.
## Crear un template manualmente
Ve a **CRM → Templates → Crear template**. Elige: **Marketing**, **Utility** o **Authentication**.
* **Marketing o Utility**: Puedes redactar texto libre, encabezados multimedia (imagen, video, documento) y botones interactivos.
* **Authentication**: Se activa el flujo de contraseñas de un solo uso (OTP). El texto del cuerpo queda bloqueado por Meta y se habilita la configuración de métodos de entrega de código y expiración.
* Ponle un nombre descriptivo (ej: "Promo Navidad 2026").
* Selecciona el idioma en el que escribirás el mensaje.
* Selecciona la instancia (número de WhatsApp) por la que se enviará.
Elige si el template lleva:
* Solo texto
* Imagen
* Video
* Documento
La imagen/video/documento que subes aquí es para la aprobación de Meta. Al enviar la campaña, debes volver a seleccionar el archivo.
* Usa formato permitido por Meta: **negrita**, *cursiva*, ~~tachado~~.
* Agrega **variables** con `{{1}}`, `{{2}}`, etc. Cada variable genera un campo de texto donde le dices a Meta un ejemplo de qué irá ahí.
* Ejemplo: "Hola `{{1}}`, tienes un cupón de descuento de `{{2}}`" → variable 1 = nombre, variable 2 = monto.
* **Botones personalizados**: texto de acción.
* **Botón con enlace**: URL externa.
* **Botón copiar**: copia un cupón o código al portapapeles.
* **Botón de teléfono**: número para llamar.
Meta revisa el template (tarda 2-24 horas). Recibirás notificación cuando se apruebe o rechace.
## Plantillas de autenticación (OTP)
Las plantillas de la categoría **Authentication** sirven para entregar contraseñas de un solo uso (OTP), por ejemplo, durante el inicio de sesión o la confirmación de una operación.
### Crear y usar una plantilla OTP
Ve a **CRM → Templates → Crear template** y selecciona la categoría **Authentication**. El cuerpo del mensaje viene definido por Meta; no es necesario redactarlo.
Elige el idioma y el tiempo de expiración del código, entre **1 y 90 minutos**. Si quieres, activa la recomendación para que el usuario no comparta el código.
Selecciona **Copiar código**, **Autocompletar con un toque** o **Autocompletar sin toque**. Las dos opciones de autocompletado requieren configurar tu aplicación Android; la opción sin toque también requiere aceptar los términos correspondientes de WhatsApp.
Cuando Meta la apruebe, podrás seleccionarla desde **Inbox** para enviarla al contacto. En el envío, introduce el OTP vigente generado por el sistema que autentica al usuario.
Shimli permite configurar y enviar la plantilla; el código debe generarlo y validarlo el sistema de autenticación de tu servicio. Usa un código vigente y respeta su tiempo de expiración.
### Reglas y restricciones de Meta
A diferencia de Marketing y Utility, las plantillas de autenticación tienen restricciones impuestas directamente por Meta:
1. **Texto del cuerpo no modificable**: No puedes redactar texto libre ni agregar promociones. Meta aplica automáticamente la fórmula estándar en el idioma seleccionado:
`{{1}} es tu código de verificación.` (en inglés: ` is your verification code.`).
2. **Sin contenido multimedia ni emojis**: No se permiten encabezados de imagen, video, documento ni ubicación, ni emojis dentro del cuerpo del mensaje.
3. **Sin URLs libres**: El cuerpo no admite enlaces arbitrarios; la interacción ocurre a través del botón OTP configurado.
4. **Recomendación de seguridad opcional**: Puedes activar la casilla *"Añadir recomendación de seguridad"* (*Add security recommendation*), que incluye automáticamente la leyenda de protección:
*"Por tu seguridad, no compartas este código."* (*For your security, do not share this code.*).
5. **Tiempo de expiración del código**: Puedes definir la caducidad del código entre **1 y 90 minutos**. Una vez vencido el tiempo, el botón de autocompletado se desactiva en el dispositivo del usuario.
6. **Período de validez del mensaje (*Message validity period*)**: Ventana recomendada dentro de la cual Meta debe entregar el mensaje antes de descartarlo. Si el mensaje no logra entregarse dentro de este lapso (por ejemplo, si el teléfono está fuera de línea), Meta no lo factura y el usuario no recibe un código obsoleto.
### Métodos de entrega de código
Al configurar una plantilla OTP en Shimli Admin, seleccionas cómo interactuará el cliente con el código en WhatsApp:
| Método de entrega | Identificador | Funcionamiento | Requisitos de configuración |
| - | - | - | - |
| **Copiar código** | `copy_code` | Muestra un botón interactivo *"Copiar código"*. El usuario toca el botón para copiar el OTP al portapapeles y pegarlo en su navegador o app. | Ninguno. Es la opción más rápida y universal. |
| **Autocompletar con un toque** | `one_tap` | Al tocar el botón en WhatsApp, el código se transmite directamente a tu app Android y se rellena el campo. Si el dispositivo no lo soporta, se degrada a copiar código. | Requiere **App setup** (nombre de paquete y hash de firma). |
| **Autocompletar sin toque** | `zero_tap` | La experiencia más fluida: WhatsApp entrega el código a la app en segundo plano sin que el usuario deba tocar ningún botón. Si no es posible, se degrada a un toque o copiar código. | Requiere **App setup** y aceptar los Términos de Servicio de WhatsApp Business para zero-tap. |
#### Configuración de la aplicación (App setup)
Para los métodos **Autocompletar con un toque** (`one_tap`) y **Autocompletar sin toque** (`zero_tap`), debes registrar los datos técnicos de tu aplicación Android (puedes agregar hasta 5 aplicaciones):
* **Nombre del paquete (*Package name*)**: Identificador único de tu app Android (ejemplo: `com.ejemplo.miapp`, hasta 224 caracteres).
* **Hash de firma de la app (*App signature hash*)**: Cadena de exactamente **11 caracteres** generada por el certificado de firma de Android (utilizado por la API SMS Retriever de Google).
* **Aceptación de términos para zero-tap**: Al seleccionar zero-tap, debes marcar la casilla confirmando que el uso de autenticación sin toque se rige por los Términos de Servicio de WhatsApp Business y que tu aplicación gestiona el consentimiento del usuario.
### Inyección de variables en el envío
En plantillas de autenticación, la variable `{{1}}` representa el código OTP generado por tu sistema:
* En tiempo de envío, Shimli inyecta automáticamente el valor de `{{1}}` tanto en el texto del cuerpo (`{{1}} es tu código...`) como en el parámetro dinámico del botón OTP (`sub_type: "url"` con `index: 0` en la WhatsApp Cloud API).
* Esto garantiza que el código mostrado y el código transferido a través de copiar código o autocompletado sean idénticos sin necesidad de mapeos adicionales.
## Variables
Las variables permiten personalizar el mensaje para cada contacto:
* Se definen con `{{1}}`, `{{2}}`, `{{3}}`, etc.
* Al crear una campaña, mapeas cada variable a una columna de tu base de datos.
* En el inbox, el agente humano puede rellenar las variables manualmente al enviar el template.
Meta requiere que proporciones un **ejemplo** del contenido de cada variable durante la creación. Esto es para que Meta sepa qué tipo de dato se enviará.
## Botones interactivos
Los botones facilitan la interacción del cliente:
| Tipo de botón | Función |
| - | - |
| Personalizado | Texto de acción (ej: "Más información") |
| Enlace | Abre una URL externa |
| Copiar | Copia un código/cupón al portapapeles |
| Teléfono | Inicia una llamada al número especificado |
## Aprobación de Meta
Meta evalúa cada template para asegurar que:
* No sea spam.
* No contenga contenido vulgar u ofensivo.
* Cumpla con las políticas de WhatsApp Business.
El proceso toma entre **2 y 24 horas**. Una vez aprobado, el template queda disponible para uso en campañas y en el inbox.
Si Meta rechaza el template, Shimli te muestra el motivo. Puedes corregir y reenviar. La IA de Shimli también puede ayudarte a identificar y corregir el problema.
## Pedir el número con una plantilla
Puedes crear una plantilla cuyo botón le pida al cliente **compartir su número de teléfono**.
Sirve para el escenario que llega con los [nombres de usuario](/whatsapp/usernames): el cliente te escribe desde su @username y no ves su número. Desde el inbox puedes pedírselo, pero eso **solo funciona dentro de la ventana de 24 horas**. Si la conversación ya se enfrió, necesitas una plantilla.
| | Desde el inbox | Con una plantilla |
| - | - | - |
| **Aprobación de Meta** | No necesita | Sí, como cualquier plantilla |
| **Cuándo puedes usarlo** | Solo dentro de las 24 horas | También fuera de la ventana |
| **Costo** | Sin costo de plantilla | Costo de envío de plantilla |
Se crea igual que cualquier otra plantilla: eliges la categoría (**marketing** o **utility**), escribes el mensaje y agregas el botón de solicitud de contacto. El texto del botón lo define WhatsApp — no lo escribes tú.
Cuando el cliente lo toca, decide si comparte su número. Si acepta, el dato entra solo a su ficha de contacto.
Ten al menos una de estas plantillas lista antes de que empiecen a llegar conversaciones sin número. Recuerda que aprobar una plantilla toma entre 2 y 24 horas.
## Editar una plantilla ya aprobada
Sí puedes editarla — no necesitas crear una nueva. Pero Meta pone límites de frecuencia:
| Estado de la plantilla | Cuántas veces puedes editarla |
| - | - |
| **Aprobada** | 1 vez cada 24 horas, y máximo 10 veces en 30 días |
| **Rechazada o pausada** | Sin límite |
Cada edición manda la plantilla de vuelta a revisión de Meta, así que mientras la revisan **no puedes usarla**. Y ojo con dos cosas:
* **No puedes cambiar la categoría** de una plantilla aprobada (de marketing a utility, por ejemplo). Para eso sí necesitas una plantilla nueva.
* Al editar el contenido **se reemplaza completo**, no se edita por partes.
Si tienes una campaña programada, no edites la plantilla poco antes de enviarla: si Meta todavía está revisando el cambio, el envío falla.
El costo depende de la categoría (marketing es más caro) y del país del destinatario. Meta publica las tarifas por mercado. Consulta [Cambios de precios de WhatsApp](/whatsapp/pricing-changes) para más contexto.
# Permisos de usuario y roles
Source: https://docs.shimli.app/guides/user-permissions
Controla qué puede ver y hacer cada agente en Shimli con permisos granulares por módulo.
Shimli permite definir **permisos granulares** por agente para controlar exactamente a qué módulos y funciones tiene acceso cada persona de tu equipo. Esto reemplaza la práctica de dar acceso de administrador a todos.
## Por qué usar permisos
Dar cuenta de administrador a todos los agentes es un riesgo de seguridad y operativo. Con permisos granulares puedes restringir el acceso a módulos sensibles sin limitar la productividad del equipo.
Beneficios:
* **Principio de mínimo privilegio**: cada agente ve solo lo que necesita.
* **Protección de datos**: restringe quién puede ver bases de datos de contactos.
* **Control de campañas**: limita quién puede crear y enviar campañas masivas.
* **Auditoría**: cada acción queda asociada al agente que la ejecutó.
## Cómo configurar permisos
Accede a **Configuración → Agentes**. Verás la lista de todos los agentes de tu cuenta.
Haz clic en el agente que quieres configurar y selecciona **Editar**.
Para cada módulo, activa o desactiva el acceso:
* **Bases de datos**: ver y gestionar listas de contactos.
* **Marketing**: crear y enviar campañas de WhatsApp y email.
* **Inbox**: atender conversaciones.
* **CRM**: ver y gestionar leads y clientes.
* **Plantillas**: crear y gestionar plantillas de WhatsApp y email.
* **Configuración**: cambios a nivel de cuenta.
Los permisos se aplican inmediatamente. El agente verá solo los módulos habilitados en su menú lateral.
## Modos de acceso
Puedes configurar cada agente de dos maneras:
| Modo | Descripción |
| - | - |
| **Administrador completo** | Acceso a todo. Úsalo solo para roles de IT o dirección. |
| **Acceso restringido** | Acceso solo a los módulos seleccionados. Recomendado para la mayoría del equipo. |
Un caso de uso común: darle acceso solo a **Marketing** al equipo de campañas, para que creen y envíen campañas sin poder tocar configuración de la cuenta ni ver bases de datos completas.
## Métricas por agente
Cada agente tiene su propio panel de métricas que muestra:
* **Conversaciones atendidas**: cuántas conversaciones ha gestionado.
* **Mensajes enviados**: volumen de mensajes del agente.
* **Eficiencia**: métrica de rendimiento calculada por Shimli.
* **Conversaciones abiertas**: cuántas tiene activas en este momento.
Estas métricas se pueden **filtrar por tiempo** (hoy, esta semana, este mes, rango personalizado) para evaluar el desempeño en distintos periodos.
Entrando al detalle de un agente ves además **por qué** cerró cada conversación, cuántos de sus cierres fueron satisfactorios y el listado completo, exportable en formato resumido o detallado.
Las métricas por agente también alimentan el dashboard del CRM, donde puedes comparar el rendimiento de todo el equipo en un solo vistazo. Ve a [CRM Dashboard](/guides/crm-dashboard#detalle-de-un-agente) para el detalle completo.
Estas métricas solo son confiables si **cada persona tiene su propio usuario**. Con un usuario compartido entre varios agentes, la actividad se acumula en uno solo y el dato individual no se puede recuperar después.
## Roles especiales
### Supervisor de inbox
El rol de **supervisor** puede monitorear y gestionar conversaciones del inbox sin ser un agente asignado. Ideal para equipos de quality assurance y soporte de segundo nivel.
### Agente de WhatsApp
Agente que atiende conversaciones de WhatsApp. Puede tener acceso a:
* Inbox (conversaciones asignadas).
* CRM (ficha del contacto).
* Plantillas (si tiene el permiso).
Sí. Ve a Configuración → Agentes, edita el agente y ajusta los permisos. Los cambios se aplican inmediatamente.
El módulo desaparece de su menú lateral. Si estaba en una página de ese módulo, será redirigido. No se pierden datos, solo se restringe el acceso.
Actualmente los permisos se configuran por agente, seleccionando los módulos a los que tiene acceso. Si necesitas roles predefinidos, configúralos como plantillas internas de tu organización.
# Formularios de WhatsApp (Flows)
Source: https://docs.shimli.app/guides/whatsapp-flows
Pide varios datos de una sola vez con un formulario que el cliente llena dentro de WhatsApp, sin salir del chat.
Un **formulario de WhatsApp** (WhatsApp Flow) es una pantalla que se abre dentro de la conversación y en la que el cliente llena varios datos de una sola vez.
Es la alternativa a preguntar dato por dato.
| Sin formulario | Con formulario |
| - | - |
| "¿Me das tu nombre?" → espera → "¿Tu número de identidad?" → espera → "¿Método de pago?" → espera | El cliente toca un botón, llena todo en una pantalla y envía |
| El agente arma la información a mano, mensaje por mensaje | Los datos llegan completos y ordenados |
| El cliente puede abandonar a mitad de camino | No puede enviar hasta completar los campos obligatorios |
| Un dato mal escrito hay que volver a pedirlo | Puedes exigir un formato y validarlo antes de enviar |
El cliente **no sale de WhatsApp** ni abre un enlace externo. Todo pasa dentro del chat.
## Crear un formulario
Ponle un nombre que reconozcas después — por ejemplo "Datos Nicaragua".
Tienes dos caminos: **describirlo con IA** o **armarlo tú**.
Pega el texto de las preguntas que hoy haces a mano y pídele que arme el formulario. La IA convierte cada pregunta en su campo correcto: texto, opción única, sí/no, número.
No necesitas saber nada de código.
También puedes agregar los campos uno por uno, o editar directamente la definición del formulario si quieres control total.
Usa la opción de prueba para verlo tal como lo verá el cliente y recorrer todos los pasos.
El formulario queda disponible para usarlo desde el inbox y desde las respuestas rápidas.
## Qué puede hacer un formulario
* **Campos de texto** — nombre, número de identidad, celular.
* **Opciones** — método de pago (efectivo o tarjeta), sí/no.
* **Pasos condicionales** — si el cliente responde "efectivo", le preguntas si necesita cambio; si responde "tarjeta", te saltas esa pregunta.
* **Campos obligatorios** — el cliente no puede enviar hasta completarlos.
* **Formato** — puedes exigir que un dato venga con cierta forma.
## Cómo lo usas en el día a día
### Desde una respuesta rápida
Es la forma más cómoda. Creas una respuesta rápida, eliges **Formulario** y seleccionas cuál. Le pones un texto de acompañamiento — por ejemplo "Para continuar, ingresa tus datos" — y la guardas.
A partir de ahí, el agente solo elige esa respuesta rápida y el formulario se envía.
### Desde el inbox
En la conversación, el agente puede enviar cualquier formulario guardado directamente desde el compositor.
### Qué ve el cliente
Le llega un mensaje con un botón. Al tocarlo se abre la pantalla del formulario, la completa y la envía. La información llega completa a la conversación — el agente no tuvo que preguntar nada.
## Preguntas frecuentes
No. El formulario en sí no tiene costo. Lo que se cobra es el mensaje que lo transporta: dentro de la ventana de 24 horas es un mensaje de servicio —gratis hasta el 1 de octubre de 2026 y después con [las reglas nuevas](/whatsapp/pricing-changes)— y fuera de ella necesitas una plantilla.
Depende de tu plan. Si necesitas más, escríbenos a [hi@shimli.app](mailto:hi@shimli.app).
No. Describe lo que quieres pedir y la IA arma el formulario. La edición manual está ahí solo por si quieres control total.
El formulario de WhatsApp se llena **dentro del chat**. El [formulario web](/guides/databases) se publica en internet y se comparte con un enlace — sirve para capturar datos fuera de la conversación, por ejemplo desde tu sitio o una campaña.
Sí. En el [Flow Builder](/flows/nodes) hay un paso de formulario de WhatsApp que lo envía dentro de un flujo, sin que un agente tenga que hacerlo a mano.
# Arquitectura
Source: https://docs.shimli.app/overview/architecture
Arquitectura conceptual de Shimli como plataforma de IA conversacional conectada a canales y sistemas empresariales.
# Arquitectura de Shimli
Shimli es una plataforma de IA conversacional cloud-native. Esta página explica la arquitectura conceptual para que entiendas cómo los canales, los agentes de IA y los sistemas de la empresa se conectan en una sola operación.
## Visión general
![Diagrama de la arquitectura conceptual de Shimli]()
## La API REST
La API de Shimli vive en `https://api.shimli.app/v1/`. Todos los endpoints comparten:
* **Autenticación por token** — se envía en el body JSON como `token` o como query param `api-token`.
* **Formato JSON** — tanto requests como responses son `application/json`.
* **Rate limiting** — aplica límites por plan para proteger el servicio.
* **CORS habilitado** — puedes llamar la API desde el navegador si es necesario.
La API no usa Bearer tokens en headers. El token va dentro del cuerpo del request como un campo `token`. Esto es intencional para simplificar la integración desde entornos sin control de headers.
## Instancias y canales
En Shimli, una **instancia** representa una conexión activa a un canal (un número de WhatsApp Business, una página de Facebook, etc.). Muchos endpoints requieren un `instance` para saber por qué canal operar.
* Un cliente puede tener **múltiples instancias** (ej. un número para ventas, otro para soporte).
* Cada instancia tiene su propio **ID de instancia** que usas en la API.
* Las instancias se gestionan desde la plataforma web de Shimli.
## Seguridad
* **TLS 1.2+** en todas las conexiones.
* **Tokens de API** únicos por cliente, rotables desde la plataforma.
* **No almacenamos datos sensibles** más allá de lo necesario para la operación del servicio.
# Introducción
Source: https://docs.shimli.app/overview/introduction
Documentación oficial de Shimli para implementar una plataforma de IA conversacional en ventas, cobranzas, soporte y operaciones.
# Introducción a esta documentación
Esta es la documentación oficial de **Shimli**, una plataforma de IA conversacional para empresas. Está pensada para que puedas entender cómo la plataforma ejecuta ventas, cobranzas, soporte y operaciones sobre canales y sistemas reales, y cómo configurarla en tu organización.
## Cómo está organizada
| Sección | Para quién | Qué encontrarás |
| - | - | - |
| **Bienvenida** | Todos | Posicionamiento de Shimli, capacidades de IA y arquitectura |
| **Empezando** | Desarrolladores | Autenticación, crear usuarios, primer mensaje, configuración de WhatsApp |
| **Guías** | Equipos técnicos y de producto | Configuración de casos de uso de IA y operación de la plataforma |
| **WhatsApp y Meta** | Equipos de producto y compliance | Usernames, verificación, cambios de pricing 2026 |
| **Referencia API** | Desarrolladores | Todos los endpoints con ejemplos y playground |
| **Recursos** | Todos | Changelog y novedades por versión |
## Convenciones
A lo largo de la documentación verás:
* `TOKEN_SHIMLI` — tu token de API personal. Reemplázalo con el tuyo real.
* `ID_INSTANCE` — el identificador de tu instancia de WhatsApp/Messenger conectada.
* `NUMBER_WHATSAPP` — un número de teléfono en formato internacional, con código de país, sin `+` ni espacios.
Nunca compartas tu token de API públicamente ni lo subas a repositorios públicos. Si se compromete, rótalo desde la plataforma de Shimli inmediatamente.
## ¿Necesitas ayuda?
* **Soporte técnico**: [hi@shimli.app](mailto:hi@shimli.app)
* **Plataforma**: [shimli.app](https://shimli.app)
* **Estado del servicio**: disponible en el dashboard de Shimli
# Características clave
Source: https://docs.shimli.app/overview/key-features
Lo que Shimli automatiza y ejecuta con IA en ventas, cobranzas, soporte y operaciones de la empresa.
![Capacidades clave de Shimli]()
## Agentes de IA que operan la empresa
El corazón de Shimli. Son agentes de IA que **ejecutan procesos de la empresa** dentro de la conversación: venden, cobran, agendan, consultan sistemas y entregan al equipo humano cuando corresponde.
### Operan en tus sistemas
* **Consultan tu ERP, tu inventario o tu base de datos** en mitad de la conversación y contestan con el dato real: el saldo, el estado del pedido, la disponibilidad.
* **Escriben también** — registran al cliente, actualizan un caso, crean el pedido.
* **Llaman a cualquier sistema externo** que tengas y siguen la conversación con lo que respondió.
### Cierran la operación
* **Venden** sobre tu catálogo real: recomiendan, arman el carrito y completan la compra en el chat.
* **Cobran solos** — desde un Excel de cuentas por cobrar negocian y cierran compromisos de pago con link directo. Ve a [Agente de cobranza](/guides/ai-debt-collection).
* **Agendan y programan** seguimientos, recordatorios y reactivaciones.
### Entienden todo lo que les mandan
* **Notas de voz** — fundamentales en Latinoamérica, y la IA las procesa como texto.
* **Fotos y comprobantes** — extrae lo que dice la imagen y sigue operando con ese dato.
* **Documentos completos** — lee un PDF largo y responde sobre su contenido.
* **Rostros** — compara la selfie del cliente con la foto de su documento para verificar identidad.
### Deciden
* **Se entrenan con tu información real**: catálogos, políticas, precios, tus documentos.
* **Pueden quedar ancladas solo a tu conocimiento**, sin improvisar sobre precios ni plazos.
* **Saben cuándo entregar** la conversación a una persona, y la pasan al área correcta con el contexto ya resuelto.
* **Tienen reglas de seguridad** que definen qué pueden hacer y en qué casos.
Ve a [Agente de IA en el flujo](/flows/ai-agent) para la configuración completa.
### La IA también construye la plataforma
* **Arma tus automatizaciones**: le describes en español lo que necesitas y el constructor la construye contigo. Ve a [Flow Builder](/flows/introduction).
* **Redacta tus plantillas** de WhatsApp y, si Meta rechaza una, te dice por qué y la corrige.
* **Escribe tus correos** y las descripciones de tus productos.
* **Analiza tus encuestas** y te da conclusiones, no solo números.
## Mensajería multi-canal
Envía y recibe mensajes desde un solo lugar a través de:
* **WhatsApp Business** — mensajería oficial para empresas, con plantillas, botones interactivos y multimedia.
* **Facebook Messenger** — mensajería directa desde tu Page de Facebook.
* **Correo electrónico** — email marketing masivo con remitentes verificados y plantillas creadas con IA.
* **SMS** — mensajería de texto para notificaciones y recordatorios.
* **Voz** — llamadas y notas de audio procesadas por IA.
Cada canal soporta texto, imagen, video, documento, audio y ubicación.
## CRM conversacional
Cada conversación es un registro de CRM. Desde la interfaz de Shimli puedes:
* **Asignar a áreas y agentes** con enrutamiento automático.
* **Etiquetar conversaciones** con tags personalizables.
* **Ver historial completo** de cada contacto en su ficha.
* **Validar números de WhatsApp** antes de enviar, directamente desde la plataforma.
Si necesitas integrar sistemas externos, Shimli también expone una API para inyectar leads y validar números. Ve a la [Referencia API](/api-reference/messaging/lead-to-crm) para más detalle.
## Campañas masivas
Crea y gestiona campañas de mensajería a escala:
* **Segmentación** por listas y campos personalizados.
* **Programación** de envíos.
* **Reportes en tiempo real** — entregados, leídos, respuestas.
* **Vista de embudo** — envíos → entregados → leídos con caída visible.
* **Motivos de rechazo** — Shimli te dice por qué cada mensaje no se entregó.
* **Asistente de IA** — analiza la campaña en lenguaje natural y exporta segmentos.
* **Límites por agente** y control de presupuesto.
La API de campañas te permite listar, consultar y obtener detalles de cada campaña. Ve a [Campañas en la referencia API](/api-reference/campaigns/list-campaigns).
## Email Marketing
Envío masivo de correos con la misma experiencia que las campañas de WhatsApp:
* **Remitentes verificados** por correo individual o por dominio (DNS).
* **Plantillas creadas con IA** — describe el correo o sube una imagen/PDF y la IA lo diseña.
* **Variables dinámicas** en asunto, texto y HTML.
* **Flujos cruzados** — si no abren el email, se dispara un WhatsApp.
* **Métricas tipo embudo** — enviados, entregados, abiertos, clics, rebotes.
Ve a la guía de [Email Marketing](/guides/email-marketing) para más detalle.
## Polls AI (Encuestas)
Crea encuestas y analiza los resultados con un asistente de IA conversacional:
* **Encuestas por WhatsApp** con calificación, opción múltiple y preguntas abiertas.
* **Métricas en tiempo real** — alcance, tasa de respuesta, detalle por pregunta.
* **Asistente de IA** que analiza los resultados en lenguaje natural y genera insights procesables.
Ve a la guía de [Polls AI](/guides/polls-ai) para más detalle.
## Automatización por eventos
La IA no espera a que le escriban: reacciona a lo que hace el cliente y encadena la siguiente acción sola.
* Si el cliente **abre el correo** → manda un WhatsApp.
* Si **no contesta** → escala a llamada.
* Si **hace clic** en un enlace → envía un seguimiento.
* Si **abandona el carrito** → lo recupera con el producto que estaba viendo.
Cada paso decidido en el momento, sobre el canal que corresponda.
## Catálogo de productos (Shop)
Commerce conversacional integrado:
* **Crear, actualizar y eliminar productos** vía API.
* **Mostrar catálogos deslizables** dentro de WhatsApp.
* **Descripciones con IA** — genera descripciones de producto automáticamente.
* **Categorización** y códigos de producto.
## Live Chat
Sesiones de chat en vivo integradas en tu sitio web:
* **Crea sesiones** de chat para visitantes.
* **Envía y recibe mensajes** en tiempo real.
* **Integra con tu CRM** para contexto completo del cliente.
## Acortador de URLs
Crea enlaces cortos con tracking integrado:
* **Acorta cualquier URL** con un identificador personalizable.
* **Actualiza el destino** de un enlace sin cambiar el short link.
* **Tracking de clics** integrado en la plataforma.
## App móvil para agentes
Tu equipo atiende desde el teléfono con **Shimli Agents**:
* **Notificaciones al instante** de cada mensaje y cada llamada entrante.
* **Todos los canales** en una sola bandeja, igual que en la web.
* **Llamadas de WhatsApp y telefónicas** con la pantalla de llamada nativa del teléfono.
* Disponible para **Android y iPhone**.
Ve a [App móvil para agentes](/getting-started/mobile-app).
## Preguntas frecuentes
Sí. Puedes usar Shimli con Facebook Messenger, Instagram, SMS, correo y otros canales sin necesidad de WhatsApp. Sin embargo, WhatsApp es el canal principal para la mayoría de nuestros clientes en Latinoamérica.
No. Puedes conectar el mismo número que ya usas en la app de WhatsApp Business y seguir usándola en el teléfono, o crear un número nuevo en la nube gestionado desde Shimli. Ve a [Conectar WhatsApp](/getting-started/whatsapp-setup).
Sí. La API de Shimli te permite sincronizar contactos, leads y conversaciones con cualquier CRM externo.
# ¿Qué es Shimli?
Source: https://docs.shimli.app/overview/what-is-shimli
Shimli es una plataforma de IA conversacional para empresas que conecta canales, equipos y sistemas para ejecutar ventas, cobranzas, soporte y operaciones reales.
Shimli es una **plataforma de IA conversacional para empresas**. Conecta canales, equipos y sistemas para ejecutar ventas, cobranzas, soporte y operaciones con contexto en tiempo real, sobre WhatsApp, Instagram, Messenger, Live Chat, correo, SMS y llamadas.
## El problema que resuelve
Casi todas las herramientas del mercado se quedan en el mismo punto: contestan mensajes. El cliente pregunta por su pedido y el bot responde *"un asesor te atenderá en breve"*. Pregunta cuánto debe, y alguien tiene que ir a buscarlo al sistema. Quiere comprar, y hay que pasarlo a otro canal.
Todo lo que de verdad mueve el negocio —consultar el saldo real, generar el pedido, cobrar, validar una identidad, agendar— sigue cayendo sobre una persona.
**Shimli cierra ese último tramo.** La IA no solo entiende: entra a tus sistemas, trae el dato, ejecuta la operación y responde con el resultado. Tu equipo deja de hacer de intermediario entre el cliente y el software, y se dedica a lo que necesita criterio humano.
## Cómo funciona
![Diagrama de cómo funciona Shimli]()
1. **Conectas tus canales** — WhatsApp, Instagram, Messenger, web, correo, SMS y llamadas.
2. **Entrenas al agente** con tu información real: catálogos, políticas, precios, documentos.
3. **Le das acciones**: consultar tu sistema, generar un pedido, cobrar, agendar, abrir un ticket.
4. **La IA opera sola** — entiende, ejecuta y responde con el resultado, no con una promesa.
5. **Tu equipo entra cuando aporta**, con el contexto ya resuelto y el caso preparado.
## Para quién es
## Lo que ejecuta la IA de Shimli
* **Ejecuta en tus sistemas**: consulta tu ERP, tu inventario o tu base de datos en mitad de la conversación y responde con el dato real. Y también escribe: registra, actualiza y crea lo que haga falta.
* **Cobra por su cuenta**: le das un Excel de cuentas por cobrar y la IA lanza la campaña, sostiene la conversación, negocia y cierra el compromiso de pago con link directo. Ve a [Agente de cobranza](/guides/ai-debt-collection).
* **Vende y cierra el pedido**: recomienda sobre tu catálogo real, arma el carrito y completa la compra dentro del chat, sin sacar al cliente a otra parte.
* **Entiende cualquier cosa que le manden**: notas de voz, fotos de un comprobante, un PDF de doce páginas. Lo lee, lo interpreta y sigue operando con esa información.
* **Verifica identidades**: compara la selfie del cliente con la foto de su documento — apertura de cuentas y trámites sensibles sin intervención manual.
* **Decide y delega**: sabe cuándo el caso la excede y entrega la conversación al área correcta, con el contexto ya resuelto.
* **Se construye hablándole**: el propio constructor de flujos tiene IA — le describes lo que necesitas en español y arma la automatización contigo. Ve a [Flow Builder](/flows/introduction).
* **Trabaja en todos tus canales**: no es un wrapper de WhatsApp. Es WhatsApp, Instagram, Messenger, Live Chat, correo, SMS y llamadas en una sola operación.
## Niveles de madurez de IA
No toda "IA" es lo mismo. Existen cuatro niveles de sofisticación:
| Nivel | Nombre | Qué hace |
| - | - | - |
| 01 | Chatbot | Flujo rígido, botones, se rompe fácil |
| 02 | NLP | Entiende intenciones simples, sigue lineal |
| 03 | **IA contextual** | Comprende lenguaje, voz e imagen. Decide. ← **Shimli** |
| 04 | **Agente autónomo** | Ejecuta en sistemas reales, persiste, recuerda y cierra el asunto. ← **Shimli** |
Shimli opera en los niveles 3 y 4. La diferencia entre presumir IA y operar con IA es simple: ¿el cliente termina su gestión en el chat, o termina esperando a que alguien la haga por él?
## Tracción
Shimli opera en **15 países** hoy, moviendo miles de conversaciones cada día en toda Latinoamérica y más allá. Una plataforma probada en producción, no una promesa.
Shimli está optimizado para mercados de **América Latina**, con soporte nativo para español y portugués, y conocimiento de las particularidades de cada país — incluyendo el manejo de notas de voz, fundamental en la región.
## Siguiente paso
Aprende sobre las [características clave](/overview/key-features) o salta directo al [inicio rápido](/getting-started/quickstart).
# Calcular tu costo
Source: https://docs.shimli.app/whatsapp/cost-calculator
Dos formas de saber cuánto te afecta el cobro de mensajes de servicio: la proyección con tus datos reales dentro de Shimli y la calculadora pública para simular escenarios.
Con el [cobro de mensajes de servicio](/whatsapp/pricing-changes) que arranca el 1 de octubre de 2026, la primera pregunta es siempre la misma: **¿a mí cuánto me toca?**
Hay dos formas de responderla, y sirven para cosas distintas.
Usa tu historial real de los últimos tres meses, número por número. Es tu punto de partida.
Para simular: otro volumen, otro mercado, otro escenario de crecimiento.
## Tu proyección, dentro de Shimli
Al entrar a tu cuenta ves una proyección calculada con **tu propio consumo**: cuántos mensajes de servicio enviaste en los últimos tres meses y cuántos habrían sido facturables con las reglas de octubre.
Lo importante es que el cálculo se hace **número por número**, que es como cobra Meta. Vas a ver, por cada línea conectada:
* Cuántos mensajes de servicio envía al mes en promedio.
* Cuántos de sus 1.000 gratis consume.
* Cuántos quedarían facturables.
Si tienes varios números, revisa el desglose y no solo el total. Una línea que se pasa de 1.000 genera costo aunque otra esté muy por debajo: los cupos no se comparten. Ahí suele estar la oportunidad más clara de ajuste.
### Cómo se calcula
Se usan meses cerrados, no el mes en curso, para que el promedio no quede corto. Si un mes tuvo una caída de servicio o datos incompletos, se excluye y se te indica.
Cada línea conectada se evalúa por separado, con su propio volumen.
De cada número se restan sus 1.000 mensajes gratis. Lo que sobra es lo facturable de esa línea.
La suma de los excedentes es tu volumen facturable proyectado por mes.
### Qué puedes ver
| Resultado | Qué significa |
| - | - |
| **Sin impacto previsto** | Ninguno de tus números supera los 1.000 mensajes al mes. Con el consumo actual, el cambio no te genera costo nuevo. |
| **Con impacto** | Al menos un número se pasa del cupo. Se te muestra el volumen facturable y en qué línea se concentra. |
| **Datos insuficientes** | Tu cuenta es nueva o no hay suficiente historial para un promedio confiable. Usa la calculadora pública con una estimación propia. |
La proyección **asume que tu operación se mantiene parecida**. Una campaña grande, una temporada alta o un número nuevo cambian el resultado. Es un punto de partida para decidir, no una factura anticipada.
## La calculadora pública
La [calculadora de impacto](https://www.shimliapp.com/calculadora-whatsapp?utm_source=docs\&utm_medium=referral\&utm_content=cost-calculator\&utm_campaign=whatsapp_pricing_oct2026) es abierta: no necesitas cuenta y puedes compartir el enlace con quien decida el presupuesto.
Sirve cuando quieres mover las variables a mano:
* **Cuántos mensajes de servicio** envías o esperas enviar al mes.
* **Cuántos números** tienes conectados.
* **Qué mercado** —el selector carga la tarifa oficial de Meta y puedes editarla si tienes una distinta.
Devuelve el volumen facturable y el costo mensual estimado.
La calculadora reparte el volumen en partes iguales entre tus números, porque solo conoce el total. Si tu operación está concentrada en una línea, el costo real será **mayor** que el que muestra. La proyección dentro de Shimli no tiene esa limitación: ahí el cálculo es número por número.
## Qué no incluye ninguna de las dos
Ambas herramientas estiman **el costo de los mensajes de servicio de Meta**. Quedan fuera:
* Las plantillas de marketing y autenticación, que mantienen su tarifa aparte.
* El agente de inteligencia artificial de Meta, que Meta factura directo al negocio.
* Impuestos, comisiones de cambio y cargos propios de tu plan.
Las **plantillas utility enviadas dentro de una ventana abierta** sí generan costo desde el 1 de octubre, pero **no consumen las 1.000 gratis**: se cobran desde la primera. En la calculadora se ingresan aparte, y en el desglose aparecen como una línea propia. Es la razón por la que un número con el cupo casi intacto puede aun así facturar.
Los montos son **aproximados**. Se basan en las tarifas que Meta publica en su [tarifario oficial](https://business.whatsapp.com/products/platform-pricing), que se actualizan cada trimestre, y **Meta es quien determina el cobro final**.
## Preguntas frecuentes
Porque parten de datos distintos. Tu proyección usa el consumo real de cada número; la calculadora usa el total que tú escribes y lo reparte en partes iguales. Cuando el volumen está concentrado en una línea, la calculadora se queda corta.
No. Solo los mensajes de servicio que salen de tu número. Los entrantes no se cobran ni consumen el cupo gratuito.
No entran en el cálculo. Las plantillas tienen su propia tarifa por categoría y no consumen las 1.000 gratis de servicio.
En ese caso verás el estado de datos insuficientes. Usa la calculadora pública con tu mejor estimación de volumen mensual y ajústala cuando tengas más recorrido.
No. Es una estimación construida con tu historial y las tarifas públicas de Meta, y sirve para dimensionar el cambio y decidir dónde optimizar. Lo que termines pagando depende de tu consumo real del mes y de tu contrato.
## Si te queda una duda
Escríbenos por [WhatsApp al +1 424 351 9915](https://wa.me/14243519915). Podemos revisar contigo el desglose por número y qué ajustes tienen más sentido en tu operación antes de octubre.
# Conexión simplificada de WhatsApp
Source: https://docs.shimli.app/whatsapp/embedded-signup
Shimli usa el proceso oficial de conexión de WhatsApp más reciente, para que conectar tu número tome minutos, no días.
Shimli usa el **proceso oficial más reciente** de WhatsApp para conectar tu número de negocio. Esto significa que puedes conectar tu WhatsApp Business de forma self-service, sin intervención manual ni trámites externos.
## Estado de Shimli
✅ **Shimli ya opera con la última versión del proceso de conexión** — conectar un número de WhatsApp toma minutos, no días.
## Qué significa para ti
* **Onboarding más rápido** — conectar un número de WhatsApp toma minutos, no días.
* **Menos fricción** — no necesitas coordinar con soporte para la mayoría de los casos.
* **Self-service real** — el proceso completo ocurre dentro de Shimli.
* **Más seguro** — la última versión incluye mejoras de seguridad y validación de identidad.
## Cómo funciona
1. En Shimli, ve a **Canales → WhatsApp → Conectar número**.
2. Inicias sesión con tu cuenta de Facebook.
3. Seleccionas o creas tu empresa y número.
4. Se valida y autoriza la conexión.
5. Tu número queda activo en Shimli automáticamente.
Si tu empresa no está verificada todavía, el flujo te guiará por el proceso de verificación. Shimli prefiere que completes esto antes para que la conexión sea inmediata.
## Requisitos
* Empresa verificada (o en proceso)
* Número de teléfono dedicado (no activo en WhatsApp estándar)
* Permisos de administrador
# Cambios de precios de WhatsApp
Source: https://docs.shimli.app/whatsapp/pricing-changes
Desde el 1 de octubre de 2026 Meta cobra los mensajes de servicio, con 1.000 gratis por número cada mes. Qué cambia, a cuánto sale y cómo prepararte.
El **1 de octubre de 2026** Meta empieza a cobrar los **mensajes de servicio**: los que hoy envías sin costo dentro de la ventana de 24 horas. Cada número recibe **1.000 gratis por mes** y el cobro arranca en el mensaje 1.001.
Esta página explica qué cambia exactamente, cuánto cuesta en tu mercado y qué conviene hacer antes de octubre.
Para ver tu número concreto —cuánto consumes hoy y cuánto se proyecta a partir de octubre— ve a [Calcular tu costo](/whatsapp/cost-calculator). Shimli te muestra la proyección con tu historial real y también hay una calculadora pública para simular escenarios.
## Las fechas que importan
| Fecha | Qué pasa |
| - | - |
| **30 de septiembre de 2026** | Último día para tener un método de pago configurado. Sin él, Meta deja de entregar tus mensajes de servicio. |
| **1 de octubre de 2026** | Los mensajes de servicio pasan a cobrarse por mensaje entregado. Arranca el nivel gratuito de 1.000 por número. |
| **1 de octubre de 2026** | Las plantillas utility enviadas dentro de una ventana abierta dejan de ser gratuitas. |
| **1 de octubre de 2026** | Meta actualiza tarifas en varios mercados. En Latinoamérica, sube Perú. |
## Qué es un mensaje de servicio
Es cualquier mensaje que tu equipo envía **dentro de la ventana de 24 horas** que se abre cuando un cliente te escribe: la respuesta de un agente, la confirmación de un pedido, el seguimiento de un reclamo. No usa plantilla y hasta septiembre de 2026 no tiene costo.
Desde octubre, cada uno de esos mensajes se cobra **a la misma tarifa que una plantilla utility de ese mercado**.
El cobro es **por mensaje entregado**, no por conversación. Si respondes una consulta en seis mensajes cortos, son seis mensajes facturables — no uno.
## Las 1.000 gratis, en detalle
Meta introdujo un nivel gratuito mensual junto con el cobro. Conviene entender bien cómo funciona, porque define si el cambio te afecta o no:
| | |
| - | - |
| **Son mensajes, no conversaciones** | Se cuentan uno a uno. |
| **Son por número de teléfono** | No es una bolsa compartida entre tus números. Cada línea tiene su propio cupo de 1.000. |
| **Se renuevan cada mes** | El contador vuelve a cero el día 1, a las 12am en la zona horaria de tu cuenta de WhatsApp. |
| **No se acumulan** | Lo que no usas en el mes se pierde; no pasa al siguiente. |
| **El cobro arranca en el 1.001** | Los primeros 1.000 de cada número siempre son gratis. |
**Que sea por número cambia la cuenta.** Si tienes dos líneas y una envía 1.100 mensajes mientras la otra envía 0, pagas 100 mensajes — no cero. El cupo de la línea inactiva no cubre a la que se pasó. Con varios números conectados, lo que importa es cómo se reparte el volumen entre ellos, no el total.
## El cupo cubre mensajes de servicio, no plantillas
Esta distinción es la que más confusión genera, y conviene tenerla clara antes de mirar cualquier número:
| | Mensaje de servicio | Plantilla utility en ventana abierta |
| - | - | - |
| **Consume las 1.000 gratis** | Sí | No |
| **Cuándo empieza a cobrarse** | En el mensaje 1.001 del número | Desde la primera |
Por eso **un número puede tener 10 de sus 1.000 mensajes usados y facturar igual**. No es un error de cálculo: si ese número envía plantillas utility dentro de conversaciones ya abiertas, esas plantillas se cobran desde la primera y no pasan por el nivel gratuito.
Si tu operación se apoya en plantillas dentro de la ventana —confirmaciones, avisos de estado, recordatorios— revisa cuáles de esos datos caben en la respuesta del agente. Ahí el mensaje de servicio sí entra en el cupo.
## Lo que sigue sin costo
* **Los mensajes que recibes.** Meta nunca cobra los mensajes entrantes del cliente.
* **La ventana de punto de entrada gratuito.** Cuando la conversación nace de un anuncio Click-to-WhatsApp o de un botón de tu página, tienes 72 horas de mensajería sin costo. Esa ventana no cambia en octubre.
* **Los primeros 1.000 mensajes de servicio de cada número, cada mes.**
Un mensaje **nunca se cobra dos veces**. Si cae dentro de una categoría ya facturada, no se le suma un cargo de servicio.
## Cuánto cuesta en tu mercado
Como el mensaje de servicio se cobra a tarifa utility, esta es la referencia que aplica. Precio en dólares **por mensaje entregado**:
| Mercado | Tarifa por mensaje (USD) |
| - | - |
| Centroamérica, Ecuador y República Dominicana | 0.0113 |
| México | 0.0085 |
| Colombia | 0.0008 |
| Brasil | 0.0068 |
| Perú | 0.0200 (sube a 0.0300 el 1 de octubre) |
| Chile | 0.0200 |
| Argentina | 0.0260 |
| España | 0.0200 |
| Estados Unidos y Canadá | 0.0034 |
Honduras, Guatemala, Nicaragua, El Salvador, Costa Rica, Panamá y República Dominicana no aparecen como países individuales en el listado de Meta: entran en **Rest of Latin America**, a 0.0113 por mensaje.
Tarifas verificadas en el [tarifario oficial de Meta](https://business.whatsapp.com/products/platform-pricing) el **2 de septiembre de 2026**. Meta las actualiza cada trimestre y es siempre la fuente final: estos valores son de referencia, no una cotización. Los mensajes de servicio **no tienen descuento por volumen**.
## Los mercados que cambian el 1 de octubre
Meta también ajusta tarifas ese día. Lo relevante para la región:
| Mercado | Qué pasa |
| - | - |
| **Centroamérica y República Dominicana** | Sin cambios. No aparecen en ninguna de las listas de actualización. |
| **Perú** | Sube la tarifa utility de **0.0200 a 0.0300**, y con ella el costo del mensaje de servicio. |
| **México** | Sube la tarifa de **marketing**. La utility —la que aplica a los mensajes de servicio— no cambia. |
Fuera de la región, el ajuste alcanza a Kazajistán, Kuwait, Marruecos, Omán, Pakistán, Sudáfrica, Ucrania, Bangladesh, Irak, Nepal, Sri Lanka, Arabia Saudita y Emiratos Árabes Unidos.
## Configura tu método de pago antes del 30 de septiembre
Meta exige un método de pago activo para seguir entregando mensajes de servicio a partir del 1 de octubre. Si no lo tienes, tus respuestas dentro de la ventana de 24 horas dejan de salir.
Si Shimli administra tu cuenta de WhatsApp, no tienes que hacer nada: la facturación con Meta ya está resuelta de nuestro lado.
Ve a **Configuración del negocio → Facturación y pagos** y confirma que hay una tarjeta vigente y sin vencer.
Si manejas varias cuentas de WhatsApp, cada una necesita su método de pago.
Si no sabes bajo qué modelo está tu cuenta, escríbenos por [WhatsApp al +1 424 351 9915](https://wa.me/14243519915) y lo revisamos contigo. Es una consulta de dos minutos y conviene resolverla antes de fin de mes.
## Cómo reducir el impacto
El costo depende de cuántos mensajes salen, no de cuántas conversaciones atiendes. Casi siempre hay margen sin perder calidad de atención:
Un mensaje de cuatro líneas cuesta lo mismo que uno de una. Si tus flujos saludan, preguntan y aclaran en mensajes separados, cada burbuja suma. Consolidar tres burbujas en una baja un tercio del costo de esa interacción.
Los avisos de "estamos cerrados" y los acuses de recibo automáticos se disparan en volumen y rara vez aportan. Ve a [Flows](/flows/introduction) para ajustarlos.
Un agente que pide los datos de a uno gasta más mensajes que uno que los pide juntos. Ve a [Agente de IA](/flows/ai-agent).
Si trabajas con anuncios Click-to-WhatsApp, esas conversaciones tienen 72 horas sin costo. Concentrar ahí el ida y vuelta largo evita cargos.
Ve a [Calcular tu costo](/whatsapp/cost-calculator) para ver tu proyección con datos reales y comprobar si los ajustes se notan.
## Meta Business Agent
Desde el 1 de agosto de 2026 Meta cobra aparte las respuestas generadas por **su propio agente de inteligencia artificial**, con un modelo por tokens (2 dólares por millón, alrededor de 4 a 5 centavos por mensaje).
Esto **no aplica a los agentes de IA de Shimli**. Si quien responde es tu equipo o un agente de Shimli, el mensaje sigue siendo de servicio y se cobra como tal.
Dos particularidades del agente de Meta: se cobra **también dentro de la ventana gratuita de 72 horas** —es la única categoría que lo hace— y Meta **factura directamente al negocio**. Si lo activas, ese cargo llega por fuera de tu factura de Shimli.
## Preguntas frecuentes
No. Meta solo cobra mensajes salientes. Los que te escriben tus clientes no tienen costo, ni consumen el cupo de 1.000.
Son 1.000 por cada número, pero no se comparten. Si un número gasta 1.400 y los otros dos gastan 200 cada uno, pagas 400 mensajes: los que se pasaron en la primera línea. El cupo sobrante de las otras dos no se transfiere.
Las plantillas de marketing, utility y autenticación siguen con su tarifa de siempre. Lo que cambia el 1 de octubre es que una plantilla **utility enviada dentro de una ventana ya abierta** deja de ser gratuita: se cobra desde la primera y no consume las 1.000 gratis, que son solo para mensajes de servicio.
Porque las 1.000 gratis cubren únicamente mensajes de servicio. Si ese número envía plantillas utility dentro de conversaciones abiertas, cada una se cobra desde la primera, sin pasar por el cupo. El cupo intacto y el costo pueden convivir.
Se reinicia a las 12am en la zona horaria configurada en tu cuenta de WhatsApp Business, que no siempre coincide con la de tu país. Si tienes dudas de cuál quedó configurada, escríbenos.
A partir del 1 de octubre Meta deja de entregar tus mensajes de servicio. Las conversaciones siguen llegando, pero tus respuestas dentro de la ventana de 24 horas no salen. Si Shimli administra tu cuenta, esto ya está cubierto.
No. Las tarifas de esta página son las que Meta publica por mensaje entregado, y sirven para dimensionar el cambio. Lo que veas facturado depende de tu contrato y del modelo bajo el que está tu cuenta.
# Nombres de usuario en WhatsApp
Source: https://docs.shimli.app/whatsapp/usernames
WhatsApp ahora soporta nombres de usuario (@handle). Shimli ya está listo para gestionarlos.
A partir de 2026, **WhatsApp comenzó a usar nombres de usuario** (@handle). Esto es un cambio enorme en cómo los clientes encuentran a las empresas en la plataforma: en lugar de buscar o guardar un número de teléfono, pueden buscar directamente por nombre.
## Por qué importa
| Antes | Ahora |
| - | - |
| El cliente necesita tu número de teléfono | El cliente busca tu @username |
| Guardar el contacto manualmente | Encontrarte directamente en la búsqueda |
| No hay forma de confirmar que eres la empresa real | Username + verificación = confianza |
Para las empresas, esto significa:
* **Más fácil de encontrar** — tus clientes te buscan por nombre de marca.
* **Menos fricción** — no necesitan guardar tu número.
* **Identidad verificable** — combinado con el check azul, tus clientes saben que eres tú.
## Lo que cambia para tu operación: el número del cliente
Hay una consecuencia que conviene tener clara. El username funciona en las dos direcciones: si tu cliente te escribe desde su @username, **tú no ves su número de teléfono**.
Shimli lo sigue identificando sin problema — cada cliente tiene un identificador propio, así que su historial, su ficha y sus conversaciones se mantienen igual. Lo que ya no llega solo es el teléfono.
Eso importa si tu operación lo necesita para algo concreto: facturar, despachar un pedido, cruzar el contacto con tu sistema o llamarlo.
### Cómo lo pides
Tienes dos formas, y el cliente siempre decide si lo comparte:
| | Cuándo usarla |
| - | - |
| **Botón en la conversación** | Dentro de la ventana de 24 horas. Sin costo de plantilla, sin aprobación de Meta. Ve a [Inbox](/guides/inbox). |
| **Plantilla que pide el número** | Cuando la conversación ya pasó las 24 horas. Requiere aprobación de Meta. Ve a [Plantillas](/guides/templates). |
Si el cliente acepta, el número entra automáticamente a su ficha de contacto.
**Todavía no es urgente.** Meta no ha anunciado la fecha en que se aplica de forma general, y hoy la mayoría de conversaciones siguen llegando con el número visible. Shimli ya tiene las dos formas listas para cuando ocurra.
Si tu proceso hoy depende de tener el teléfono desde el primer mensaje, vale la pena revisarlo antes de que el cambio llegue: es un paso extra que antes no existía, y el cliente puede decir no.
## Shimli ya está listo
Shimli ya tiene integrado el soporte completo para usernames de WhatsApp:
✅ **Reserva de username habilitada** — ya puedes reservar tu nombre de usuario desde Shimli.
✅ **Notificación in-app** — cuando entras a Shimli, aparece una notificación pidiéndote reservar tu nombre.
✅ **Correo de aviso enviado** — se mandó comunicación a todos los clientes sobre esta funcionalidad.
## Cómo reservar tu username
1. Inicia sesión en [shimli.app](https://shimli.app).
2. Verás la notificación pidiéndote reservar tu username.
3. Ve a **Canales → WhatsApp → Username**.
4. Ingresa el nombre que quieres (ej: `@BancoLatam`).
5. Shimli verifica disponibilidad con Meta.
6. Si está libre, lo reserva inmediatamente.
Los usernames son únicos a nivel global en WhatsApp. Te recomendamos reservar el tuyo lo antes posible, antes de que alguien más lo tome. Prioriza el nombre de tu marca exacto.
## Buenas prácticas
* **Usa el nombre exacto de tu marca** — si eres "BancoLatam", reserva `@BancoLatam`, no `@bancolatam_oficial`.
* **Reserva variantes** si tu marca es propensa a imitaciones.
* **Combina con verificación** — un username sin check azul es menos confiable que uno verificado. Solicita la [verificación de Official Business Account](/whatsapp/verification) también.
* **Comunica el cambio** — avisa a tus clientes que ahora pueden encontrarte por @username en WhatsApp.
# Verificación de Official Business Account
Source: https://docs.shimli.app/whatsapp/verification
Solicita el check azul de WhatsApp Business directamente desde Shimli.
La verificación de **Official Business Account (OBA)** de WhatsApp otorga el **check azul** a tu cuenta de WhatsApp Business. Esto confirma que tu empresa es auténtica y mejora drásticamente la confianza de tus clientes.
Antes este distintivo era **verde**. WhatsApp lo cambió a **azul** — es la misma verificación, solo cambió el color.
## Shimli ya lo gestiona
✅ **Verificación de OBA habilitada desde Shimli** — ya puedes gestionar todo el proceso de verificación directamente desde la plataforma, sin necesidad de salir de Shimli.
## Qué necesitas para la verificación
Tu empresa debe estar verificada. Esto requiere documentos legales (registro mercantil, licencia comercial, etc.). Shimli te guía en el proceso.
Tu número debe estar conectado y operativo en Shimli.
El nombre visible de tu WhatsApp debe coincidir con el nombre legal de tu empresa o marca registrada.
Ve a **Canales → WhatsApp → Verificación** y haz clic en **Enviar solicitud**. Llenas el formulario ahí mismo — país donde operas, idioma, datos de la empresa y los enlaces de respaldo — y Shimli envía la solicitud por ti.
### Los enlaces de respaldo
Es la parte donde más solicitudes se caen. WhatsApp pide enlaces que demuestren que tu marca es **reconocida públicamente**, y los revisa una persona.
| Sirve | No sirve |
| - | - |
| Un artículo de prensa o periódico sobre tu empresa | Tu propio sitio web |
| Un premio o reconocimiento que recibieron | Tus redes sociales |
| Una nota en un medio del sector | Tu perfil en un directorio de empresas |
Los enlaces no pueden ser tuyos. La idea es que un tercero hable de tu marca — eso es lo que WhatsApp entiende como notoriedad.
## Qué pasa después de solicitar
1. **Revisión de la solicitud** — típicamente toma 2-7 días hábiles.
2. **Aprobación o rechazo** — recibirás notificación en Shimli.
3. **Si se aprueba** — el check azul aparece en tu cuenta de WhatsApp.
4. **Si se rechaza** — Shimli te muestra el motivo y puedes corregir y reaplicar.
El check azul es permanente mientras mantengas tu cuenta en buen estado y cumplas las políticas de WhatsApp Business. No necesitas renovarlo.
## Cambio de nombre de WhatsApp
Si necesitas cambiar el nombre visible de tu WhatsApp (por ejemplo, por un rebranding), puedes solicitarlo desde Shimli. El cambio está sujeto a aprobación.
## Combinar con username
La verificación de OBA funciona mejor cuando se combina con un [nombre de usuario reservado](/whatsapp/usernames). Juntos, ofrecen la máxima confianza:
* **@username** → fácil de encontrar
* **Check azul** → confirma que eres la empresa real
Para empresas fintech, de banca y servicios financieros, la verificación de marca es prácticamente obligatoria. Sin check azul, los clientes dudan de la autenticidad de los mensajes.