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

# API de YCloud

> Cree flujos de trabajo de mensajería, verificación, contactos y eventos con las API de YCloud.

YCloud proporciona una sola API para las comunicaciones con los clientes y los flujos de trabajo de interacción. Puede enviar mensajes de WhatsApp, SMS, correo electrónico y voz. También puede verificar usuarios, gestionar contactos, rastrear eventos personalizados y recibir actualizaciones de estado a través de webhooks.

## Cómo funcionan las solicitudes

Todas las solicitudes del lado del servidor utilizan esta URL base:

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
https://api.ycloud.com/v2
```

Autentique las solicitudes con una clave de API en el encabezado `X-API-Key`. Mantenga la clave en su servidor y nunca la exponga en el código del navegador o de la aplicación móvil.

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl https://api.ycloud.com/v2/balance \
  --header "X-API-Key: $YCLOUD_API_KEY" \
  --header "Accept: application/json"
```

<CardGroup cols={2}>
  <Card title="Inicio rápido" icon="rocket" href="/es/api-reference/getting-started/quickstart">
    Configure su clave de API y realice su primera solicitud autenticada.
  </Card>

  <Card title="Autenticación" icon="key" href="/es/api-reference/guides/api-fundamentals/authentication">
    Almacene y utilice su clave de API de YCloud de forma segura.
  </Card>

  <Card title="Webhooks" icon="webhook" href="/es/api-reference/guides/api-fundamentals/configure-webhooks">
    Reciba actualizaciones del estado de los mensajes y mensajes entrantes.
  </Card>

  <Card title="Guías" icon="book-open" href="/es/api-reference/guides/overview">
    Siga guías prácticas para flujos de trabajo de integración comunes.
  </Card>
</CardGroup>

## Qué puede crear

<CardGroup cols={2}>
  <Card title="Experiencias de WhatsApp" icon="whatsapp" href="/es/api-reference/guides/whatsapp-platform/send-whatsapp-message">
    Envíe plantillas, texto, contenido multimedia, mensajes interactivos y más.
  </Card>

  <Card title="SMS y voz" icon="comment-sms" href="/es/api-reference/guides/messaging/send-sms">
    Envíe mensajes SMS globales y códigos de voz automatizados.
  </Card>

  <Card title="Correo electrónico" icon="envelope" href="/es/api-reference/guides/messaging/send-email">
    Envíe correos electrónicos en HTML o texto sin formato desde un dominio activado.
  </Card>

  <Card title="Plataforma de WhatsApp" icon="building" href="/es/api-reference/guides/whatsapp-platform/manage-whatsapp-business-accounts">
    Gestione WABA, números de teléfono, plantillas, Flows, archivos multimedia y llamadas.
  </Card>

  <Card title="Datos de clientes" icon="address-card" href="/es/api-reference/guides/customer-data-and-operations/manage-contacts">
    Gestione contactos, eventos personalizados y cancelaciones de suscripción por canal.
  </Card>
</CardGroup>

## Solicitud

Envíe cuerpos de solicitud JSON con `Content-Type: application/json`. Los parámetros
de ruta y de consulta se documentan en la página de cada endpoint.

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl --request POST https://api.ycloud.com/v2/sms \
  --header "X-API-Key: $YCLOUD_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "to": "+16315551234",
    "text": "Your order has shipped."
  }'
```

Utilice la Referencia de la API cuando necesite el esquema de solicitud completo, valores de enumeración
o un generador interactivo de solicitudes.

## Respuesta

Las respuestas exitosas utilizan JSON. Una respuesta de creación o envío confirma que YCloud
aceptó la solicitud. No siempre confirma la entrega o finalización definitivas.
Guarde el ID de recurso devuelto y correlaciónelo con los resultados de recuperación o
los eventos de webhook.

Los errores incluyen un `code` legible por máquina, un `message` para desarrolladores y un
`requestId` que puede proporcionar al equipo de soporte de YCloud.

<Note>
  Algunos productos requieren la activación de la cuenta, un remitente aprobado o una cuenta de WhatsApp Business conectada antes de poder enviar mensajes.
</Note>

## De la guía a la referencia de la API

<CardGroup cols={2}>
  <Card title="Guía de WhatsApp" icon="whatsapp" href="/es/api-reference/guides/whatsapp-platform/send-whatsapp-message">
    Comprenda las ventanas de mensajes, los modos de envío, los campos de solicitud y los estados de entrega.
  </Card>

  <Card title="Endpoint de WhatsApp" icon="code" href="/api-reference/whatsapp-messages/send-a-message-directly">
    Inspeccione el esquema completo de solicitud y respuesta de envío directo.
  </Card>

  <Card title="Guía de SMS" icon="comment-sms" href="/es/api-reference/guides/messaging/send-sms">
    Descubra cómo funcionan las solicitudes de SMS y las actualizaciones de entrega.
  </Card>

  <Card title="Endpoint de SMS" icon="code" href="/api-reference/sms/send-an-sms">
    Inspeccione el esquema completo de solicitud y respuesta de SMS.
  </Card>
</CardGroup>


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