> ## Documentation Index
> Fetch the complete documentation index at: https://docs.shimli.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Enviar tu primer mensaje vía API

> 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.md).

## Antes de empezar

* Ten un [token de API](/getting-started/authentication.md).
* 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.md).

## 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.md) 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.md) 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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.