# Elocuenti API

> La documentación de la API pública de Elocuenti en Markdown, para agentes de IA: cada página y cada guía, en español y en inglés.
>
> Elocuenti's public API documentation in Markdown, for AI agents: every page and every guide, in Spanish and in English.

Cada petición va a `https://www.elocuenti.com/api/v1` con tu key en el header `Authorization: Bearer $ELOCUENTI_API_KEY`. Las keys se crean en [Configuración → API Keys](https://www.elocuenti.com/dashboard/settings?tab=api-keys): una por integración, con sólo los permisos que usa. La key se muestra una sola vez.

El ambiente lo decide la key: `eloc_sand_…` es sandbox y `eloc_live_…` es producción. Una key de sandbox nunca le escribe ni le llama a un cliente y nunca mueve dinero real.

Every request goes to `https://www.elocuenti.com/api/v1` with your key in the `Authorization: Bearer $ELOCUENTI_API_KEY` header. Keys are created in [Settings → API Keys](https://www.elocuenti.com/dashboard/settings?tab=api-keys): one per integration, with only the permissions it uses. The key is shown only once.

The key decides the environment: `eloc_sand_…` is sandbox and `eloc_live_…` is production. A sandbox key never writes to or calls a customer and never moves real money.

## Documentación en español

- [Inicio](https://www.elocuenti.com/api/docs.md?lang=es): Integra tu sistema con Elocuenti: contactos, conversaciones de todos tus canales, automatizaciones, llamadas de tu IA, cobros y webhooks.
- [Primeros pasos](https://www.elocuenti.com/api/docs/quickstart.md?lang=es): Tu primera llamada a la API de Elocuenti en menos de 5 minutos, con una key de sandbox.
- [Conceptos básicos](https://www.elocuenti.com/api/docs/conventions.md?lang=es): Autenticación, keys y roles, sandbox, idempotencia, paginación, límites, la forma de los errores y la auditoría de la API de Elocuenti.
- [Guías](https://www.elocuenti.com/api/docs/guides.md?lang=es): Guías paso a paso para integrar Elocuenti: vender, atender y automatizar.
- [Recuperar carritos abandonados](https://www.elocuenti.com/api/docs/guides/carts.md?lang=es): La IA le escribe al comprador por WhatsApp y lo acompaña hasta que compra.
- [Confirmar compras](https://www.elocuenti.com/api/docs/guides/orders.md?lang=es): La confirmación de la compra por WhatsApp, sin duplicados aunque reintentes.
- [Pedir opinión después de la compra](https://www.elocuenti.com/api/docs/guides/feedback.md?lang=es): Una encuesta por WhatsApp; la IA recoge la calificación y el comentario.
- [Enviar mensajes por WhatsApp](https://www.elocuenti.com/api/docs/guides/messages.md?lang=es): Plantillas y textos desde tu sistema, con su estado de entrega.
- [Crear plantillas de WhatsApp](https://www.elocuenti.com/api/docs/guides/templates.md?lang=es): Crea tus plantillas, sigue la revisión de WhatsApp y envíalas con sus variables.
- [Mantener tus contactos al día](https://www.elocuenti.com/api/docs/guides/contacts.md?lang=es): Crea, busca y actualiza contactos; etiquetas, datos para la IA y borrado.
- [Pasar una conversación entre la IA y tu equipo](https://www.elocuenti.com/api/docs/guides/handoff.md?lang=es): Pausa la IA, asigna la conversación a una persona y devuélvesela a la IA.
- [Dejar notas internas](https://www.elocuenti.com/api/docs/guides/notes.md?lang=es): Notas para tu equipo que el cliente nunca ve, las mismas del panel.
- [Mover conversaciones entre etapas](https://www.elocuenti.com/api/docs/guides/pipelines.md?lang=es): Cambia de etapa una conversación y lee lo que capturó la IA.
- [Mantener tu base de conocimiento al día](https://www.elocuenti.com/api/docs/guides/knowledge.md?lang=es): Sincroniza lo que sabe tu IA con tu CMS o tu centro de ayuda.
- [Iniciar una automatización](https://www.elocuenti.com/api/docs/guides/automations.md?lang=es): Dispara una automatización para un contacto y sigue la corrida.
- [Enviar los eventos de tu sistema](https://www.elocuenti.com/api/docs/guides/events.md?lang=es): Lo que tus clientes hacen en tu sistema, en el historial de cada contacto.
- [Pedirle a tu IA que llame a un contacto](https://www.elocuenti.com/api/docs/guides/calls.md?lang=es): Una llamada real de tu IA a un contacto, y cómo le fue.
- [Cobros](https://www.elocuenti.com/api/docs/payments.md?lang=es): Crea cobros con Elopay desde tu sistema: en pesos o en dólares, con los medios de pago que elijas, y confirma el pago.
- [Pago en tu web](https://www.elocuenti.com/api/docs/checkout.md?lang=es): Abre la pantalla de pago de Elopay en tu web: el link, un modal sobre tu tienda o un iframe dentro de tu página.
- [Webhooks](https://www.elocuenti.com/api/docs/webhooks.md?lang=es): Recibe en tu servidor los eventos de tu negocio y el aviso de cada cobro, firmados.
- [Referencia](https://www.elocuenti.com/api/docs/reference.md?lang=es): Cada operación de la API de Elocuenti con su acceso, sus campos, sus respuestas y ejemplos.
- [Errores](https://www.elocuenti.com/api/docs/errors.md?lang=es): Cada código de error de la API de Elocuenti: qué pasó y qué hacer.
- [Cambios](https://www.elocuenti.com/api/docs/versions.md?lang=es): Cómo evoluciona la API de Elocuenti sin romper tu integración, y qué se agregó y cuándo.
- [OpenAPI](https://www.elocuenti.com/api/v1/openapi.json): El contrato completo en OpenAPI 3.1, en inglés: cada operación, sus campos y sus respuestas.
- [llms-full.txt](https://www.elocuenti.com/api/docs/llms-full.txt?lang=es): Todo el portal en español, en un archivo

## Documentation in English

- [Home](https://www.elocuenti.com/api/docs.md?lang=en): Integrate your system with Elocuenti: contacts, conversations from all your channels, automations, calls by your AI, charges and webhooks.
- [Quickstart](https://www.elocuenti.com/api/docs/quickstart.md?lang=en): Your first call to the Elocuenti API in under 5 minutes, with a sandbox key.
- [Basics](https://www.elocuenti.com/api/docs/conventions.md?lang=en): Authentication, keys and roles, sandbox, idempotency, pagination, limits, the shape of errors and the audit of the Elocuenti API.
- [Guides](https://www.elocuenti.com/api/docs/guides.md?lang=en): Step-by-step guides to integrate Elocuenti: sell, serve and automate.
- [Recover abandoned carts](https://www.elocuenti.com/api/docs/guides/carts.md?lang=en): The AI writes to the buyer over WhatsApp and stays with them until they buy.
- [Confirm purchases](https://www.elocuenti.com/api/docs/guides/orders.md?lang=en): The purchase confirmation over WhatsApp, with no duplicates even if you retry.
- [Ask for feedback after a purchase](https://www.elocuenti.com/api/docs/guides/feedback.md?lang=en): A survey over WhatsApp; the AI collects the rating and the comment.
- [Send messages over WhatsApp](https://www.elocuenti.com/api/docs/guides/messages.md?lang=en): Templates and texts from your system, with their delivery status.
- [Create WhatsApp templates](https://www.elocuenti.com/api/docs/guides/templates.md?lang=en): Create your templates, follow WhatsApp's review and send them with their variables.
- [Keep your contacts up to date](https://www.elocuenti.com/api/docs/guides/contacts.md?lang=en): Create, find and update contacts; tags, data for the AI and erasure.
- [Hand a conversation between the AI and your team](https://www.elocuenti.com/api/docs/guides/handoff.md?lang=en): Pause the AI, assign the conversation to a person and hand it back to the AI.
- [Leave internal notes](https://www.elocuenti.com/api/docs/guides/notes.md?lang=en): Notes for your team that the customer never sees, the same ones as in the dashboard.
- [Move conversations between stages](https://www.elocuenti.com/api/docs/guides/pipelines.md?lang=en): Move a conversation to another stage and read what the AI captured.
- [Keep your knowledge base up to date](https://www.elocuenti.com/api/docs/guides/knowledge.md?lang=en): Sync what your AI knows with your CMS or help center.
- [Start an automation](https://www.elocuenti.com/api/docs/guides/automations.md?lang=en): Start an automation for a contact and follow the run.
- [Send the events of your system](https://www.elocuenti.com/api/docs/guides/events.md?lang=en): What your customers do in your system, in each contact's history.
- [Ask your AI to call a contact](https://www.elocuenti.com/api/docs/guides/calls.md?lang=en): A real call by your AI to a contact, and how it went.
- [Charges](https://www.elocuenti.com/api/docs/payments.md?lang=en): Create Elopay charges from your system: in pesos or in dollars, with the payment methods you choose, and confirm the payment.
- [Checkout on your site](https://www.elocuenti.com/api/docs/checkout.md?lang=en): Open the Elopay payment screen on your site: the link, a modal over your store or an iframe inside your page.
- [Webhooks](https://www.elocuenti.com/api/docs/webhooks.md?lang=en): Receive the events of your business and the notification of every charge on your server, signed.
- [Reference](https://www.elocuenti.com/api/docs/reference.md?lang=en): Every operation of the Elocuenti API with its access, its fields, its answers and examples.
- [Errors](https://www.elocuenti.com/api/docs/errors.md?lang=en): Every error code of the Elocuenti API: what happened and what to do.
- [Changes](https://www.elocuenti.com/api/docs/versions.md?lang=en): How the Elocuenti API evolves without breaking your integration, and what was added and when.
- [OpenAPI](https://www.elocuenti.com/api/v1/openapi.json): The full contract in OpenAPI 3.1, in English: every operation, its fields and its answers.
- [llms-full.txt](https://www.elocuenti.com/api/docs/llms-full.txt?lang=en): The whole portal in English, in one file