# Sofia Chat

- [Primeros pasos](https://docs.sofiachat.com/guia/01-primeros-pasos.md): Crea tu cuenta, configura tu organización en tres pasos y conoce la navegación del panel.
- [Dashboard](https://docs.sofiachat.com/guia/02-dashboard.md): Lee la operación del día de un vistazo y construye tu propio panel de métricas.
- [Conversaciones](https://docs.sofiachat.com/guia/03-conversaciones.md): La bandeja: estados, filtros, acciones rápidas, exportación y vista previa.
- [Detalle de conversación](https://docs.sofiachat.com/guia/04-detalle-de-conversacion.md): La vista de trabajo del agente: tomar, responder, devolver a la IA, resolver, clasificar y gestionar al cliente.
- [Atención humana (HITL)](https://docs.sofiachat.com/guia/05-hitl.md): Cómo pasa una conversación de la IA a una persona, y cómo organizar tipos de intervención humana.
- [CRM](https://docs.sofiachat.com/guia/06-crm.md): Pipelines con tablero kanban, negocios (deals), ficha de clientes y tareas.
- [Contactos](https://docs.sofiachat.com/guia/07-outbound/contactos.md): La base de destinatarios para campañas: alta, importación masiva, campos personalizados, grupos y bajas.
- [Plantillas de WhatsApp](https://docs.sofiachat.com/guia/07-outbound/plantillas.md): Mensajes preaprobados por Meta: cuándo hacen falta, cómo crearlas para que las aprueben y cómo mantenerlas sincronizadas.
- [Campañas](https://docs.sofiachat.com/guia/07-outbound/campanas.md): Envíos masivos de una plantilla a una audiencia de contactos, con resultado por destinatario.
- [El editor de Espacios](https://docs.sofiachat.com/guia/08-espacios/editor.md): Dónde se configura todo lo que atiende: el agente de IA, su conocimiento, sus herramientas y sus canales.
- [Agente de IA](https://docs.sofiachat.com/guia/08-espacios/agente.md): Instrucciones, modelo, temperatura, escalado a humano y base de conocimiento.
- [Herramientas](https://docs.sofiachat.com/guia/08-espacios/herramientas.md): Funciones HTTP que el agente puede ejecutar: catálogo de integraciones, parámetros, pruebas y autenticación.
- [Canales](https://docs.sofiachat.com/guia/08-espacios/canales.md): Conectar WhatsApp, personalizar el Chat Web e integrar Telegram, Slack y Messenger.
- [Departamentos](https://docs.sofiachat.com/guia/09-departamentos.md): Unidades de atención con su propio agente de IA, canales y equipo.
- [Usuarios y permisos](https://docs.sofiachat.com/guia/10-usuarios-y-permisos.md): Invitar personas, asignar roles y departamentos, y entender qué puede hacer cada rol.
- [Tags](https://docs.sofiachat.com/guia/11-tags.md): Etiquetas que clasifican conversaciones, deciden qué agentes las ven y segmentan las métricas.
- [Plan y facturación](https://docs.sofiachat.com/guia/12-plan-y-facturacion.md): Tu plan, el consumo del período, cambiar de plan y gestionar la suscripción.
- [Integraciones y API](https://docs.sofiachat.com/guia/13-integraciones-api.md): Crear y administrar API keys para conectar Sofia Chat con tus sistemas.
- [Glosario](https://docs.sofiachat.com/guia/anexos/glosario.md): Términos que aparecen en el panel y en esta guía.
- [Mensajes de error frecuentes](https://docs.sofiachat.com/guia/anexos/errores.md): Qué significa cada aviso y qué hacer.
- [Preguntas frecuentes](https://docs.sofiachat.com/guia/anexos/faq.md): Respuestas rápidas a las dudas más habituales.
- [Introducción](https://docs.sofiachat.com/desarrolladores/introduccion.md): Integra Sofia Chat con tu CRM, ERP o cualquier sistema mediante la API pública v1: URL base, formato y tu primer request.
- [Autenticación](https://docs.sofiachat.com/desarrolladores/autenticacion.md): Autentica con API keys (X-API-Key): formato, scopes, expiración, límites y rate limiting.
- [Formato de respuestas y errores](https://docs.sofiachat.com/desarrolladores/formato-y-errores.md): Estructura de las respuestas (data / meta / error) y los códigos HTTP que devuelve la API.
- [Paginación y límites](https://docs.sofiachat.com/desarrolladores/paginacion-y-limites.md): Cómo pagina la API (page, limit, meta.total) y cómo respeta el plan de la organización.
- [Tutorial: tu primera campaña por API](https://docs.sofiachat.com/desarrolladores/tutorial-campana.md): El flujo completo de una campaña de WhatsApp en v1, de la API key al reporte de entrega, con ejemplos en cURL, Node y Python.
- [Recetas de integración](https://docs.sofiachat.com/desarrolladores/recetas.md): Patrones comunes: notificaciones transaccionales, sincronización de CRM, campañas automatizadas y escalado a humano.
- [Códigos de error](https://docs.sofiachat.com/desarrolladores/codigos-de-error.md): La lista completa de códigos de error estables (code) de la API v1, con su HTTP y descripción.
- [Referencia de API v1](https://docs.sofiachat.com/referencia-de-api/introduccion.md): Referencia interactiva de la API pública v1 de Sofia Chat, generada desde OpenAPI, con un playground para probar cada endpoint.
- [Contexto de la API key: organización, plan y la propia key](https://docs.sofiachat.com/api-reference/cuenta/contexto-de-la-api-key:-organización-plan-y-la-propia-key.md)
- [Envía un mensaje de WhatsApp (texto, plantilla, imagen o documento)](https://docs.sofiachat.com/api-reference/mensajes/envía-un-mensaje-de-whatsapp-texto-plantilla-imagen-o-documento.md)
- [Estado de un mensaje por id](https://docs.sofiachat.com/api-reference/mensajes/estado-de-un-mensaje-por-id.md)
- [Historial de mensajes de una conversación (más recientes primero)](https://docs.sofiachat.com/api-reference/conversaciones/historial-de-mensajes-de-una-conversación-más-recientes-primero.md)
- [Lista contactos de la organización](https://docs.sofiachat.com/api-reference/contactos/lista-contactos-de-la-organización.md)
- [Crea un contacto (wa_identified se deriva del teléfono en el servidor)](https://docs.sofiachat.com/api-reference/contactos/crea-un-contacto-wa_identified-se-deriva-del-teléfono-en-el-servidor.md)
- [Obtiene un contacto por id](https://docs.sofiachat.com/api-reference/contactos/obtiene-un-contacto-por-id.md)
- [Elimina un contacto (soft delete)](https://docs.sofiachat.com/api-reference/contactos/elimina-un-contacto-soft-delete.md)
- [Actualiza un contacto](https://docs.sofiachat.com/api-reference/contactos/actualiza-un-contacto.md)
- [Marca opt-out (baja) del contacto](https://docs.sofiachat.com/api-reference/contactos/marca-opt-out-baja-del-contacto.md)
- [Revierte el opt-out del contacto](https://docs.sofiachat.com/api-reference/contactos/revierte-el-opt-out-del-contacto.md)
- [Importa contactos desde un archivo xlsx/csv; retorna created/updated/errors](https://docs.sofiachat.com/api-reference/contactos/importa-contactos-desde-un-archivo-xlsxcsv;-retorna-createdupdatederrors.md)
- [Lista los campos personalizados de contacto](https://docs.sofiachat.com/api-reference/campos-de-contacto/lista-los-campos-personalizados-de-contacto.md)
- [Crea un campo personalizado de contacto](https://docs.sofiachat.com/api-reference/campos-de-contacto/crea-un-campo-personalizado-de-contacto.md)
- [Elimina un campo (soft delete)](https://docs.sofiachat.com/api-reference/campos-de-contacto/elimina-un-campo-soft-delete.md)
- [Actualiza un campo (la key es inmutable)](https://docs.sofiachat.com/api-reference/campos-de-contacto/actualiza-un-campo-la-key-es-inmutable.md)
- [Lista los grupos de contactos con su conteo de miembros](https://docs.sofiachat.com/api-reference/grupos-de-contactos/lista-los-grupos-de-contactos-con-su-conteo-de-miembros.md)
- [Crea un grupo de contactos](https://docs.sofiachat.com/api-reference/grupos-de-contactos/crea-un-grupo-de-contactos.md)
- [Obtiene un grupo por id](https://docs.sofiachat.com/api-reference/grupos-de-contactos/obtiene-un-grupo-por-id.md)
- [Elimina un grupo (soft delete)](https://docs.sofiachat.com/api-reference/grupos-de-contactos/elimina-un-grupo-soft-delete.md)
- [Actualiza un grupo de contactos](https://docs.sofiachat.com/api-reference/grupos-de-contactos/actualiza-un-grupo-de-contactos.md)
- [Agrega contactos a un grupo](https://docs.sofiachat.com/api-reference/grupos-de-contactos/agrega-contactos-a-un-grupo.md)
- [Quita contactos de un grupo](https://docs.sofiachat.com/api-reference/grupos-de-contactos/quita-contactos-de-un-grupo.md)
- [Lista los tags de conversación de la organización](https://docs.sofiachat.com/api-reference/etiquetas/lista-los-tags-de-conversación-de-la-organización.md)
- [Crea un tag de conversación](https://docs.sofiachat.com/api-reference/etiquetas/crea-un-tag-de-conversación.md)
- [Obtiene un tag por id](https://docs.sofiachat.com/api-reference/etiquetas/obtiene-un-tag-por-id.md)
- [Elimina un tag de conversación (soft delete)](https://docs.sofiachat.com/api-reference/etiquetas/elimina-un-tag-de-conversación-soft-delete.md)
- [Actualiza un tag de conversación](https://docs.sofiachat.com/api-reference/etiquetas/actualiza-un-tag-de-conversación.md)
- [Lista las plantillas de la organización (opcional por canal/estado)](https://docs.sofiachat.com/api-reference/plantillas/lista-las-plantillas-de-la-organización-opcional-por-canalestado.md)
- [Crea una plantilla y la envía a Meta para aprobación](https://docs.sofiachat.com/api-reference/plantillas/crea-una-plantilla-y-la-envía-a-meta-para-aprobación.md)
- [Sincroniza las plantillas de un canal con Meta](https://docs.sofiachat.com/api-reference/plantillas/sincroniza-las-plantillas-de-un-canal-con-meta.md)
- [Obtiene una plantilla por id](https://docs.sofiachat.com/api-reference/plantillas/obtiene-una-plantilla-por-id.md)
- [Elimina una plantilla (solo pending/rejected/disabled)](https://docs.sofiachat.com/api-reference/plantillas/elimina-una-plantilla-solo-pendingrejecteddisabled.md)
- [Lista las campañas de la organización](https://docs.sofiachat.com/api-reference/campañas/lista-las-campañas-de-la-organización.md)
- [Crea una campaña](https://docs.sofiachat.com/api-reference/campañas/crea-una-campaña.md)
- [Obtiene una campaña por id](https://docs.sofiachat.com/api-reference/campañas/obtiene-una-campaña-por-id.md)
- [Lista los destinatarios de una campaña](https://docs.sofiachat.com/api-reference/campañas/lista-los-destinatarios-de-una-campaña.md)
- [Inicia el envío de una campaña](https://docs.sofiachat.com/api-reference/campañas/inicia-el-envío-de-una-campaña.md)
- [Cancela una campaña](https://docs.sofiachat.com/api-reference/campañas/cancela-una-campaña.md)
- [Lista los chat users con conversaciones en la organización](https://docs.sofiachat.com/api-reference/usuarios-de-chat/lista-los-chat-users-con-conversaciones-en-la-organización.md)
- [Obtiene la información completa de un chat user](https://docs.sofiachat.com/api-reference/usuarios-de-chat/obtiene-la-información-completa-de-un-chat-user.md)
- [Actualiza campos estándar y/o personalizados de un chat user](https://docs.sofiachat.com/api-reference/usuarios-de-chat/actualiza-campos-estándar-yo-personalizados-de-un-chat-user.md)

## OpenAPI Specs

- [openapi](https://api-v2.sofiachat.com/api/v1/openapi.json)