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

# Comunicaciones

> Guía completa del módulo de comunicaciones de Yampi.ai: conversaciones, mensajes, canales e integraciones.

## Introducción

El módulo de comunicaciones de Yampi.ai es un sistema de omnicanalidad que centraliza todas tus interacciones con propietarios, inquilinos y prospectos en un único lugar.

Permite gestionar conversaciones desde múltiples canales (WhatsApp, Email, SMS, Facebook, Instagram, TikTok, Chat Web y Canal de Voz) en una sola interfaz.

<Info>
  Todas las conversaciones se almacenan con contexto completo, incluyendo historial de mensajes, información del contacto, propiedades relacionadas y actividad previa.
</Info>

## Componentes principales

El módulo de comunicaciones está compuesto por tres elementos fundamentales:

### Conversaciones

Las conversaciones representan el hilo de comunicación con un contacto. Cada conversación agrupa todos los mensajes intercambiados y mantiene información sobre el estado, prioridad, asignación y contexto.

<CardGroup cols={2}>
  <Card title="Estados" icon="circle-check">
    **Open**: Conversación activa\
    **Resolved**: Conversación cerrada\
    **Pending**: Esperando procesamiento\
    **Snoozed**: Pausada temporalmente
  </Card>

  <Card title="Prioridades" icon="flag">
    **Low**: Prioridad baja\
    **Medium**: Prioridad media\
    **High**: Prioridad alta\
    **Urgent**: Urgente
  </Card>
</CardGroup>

### Mensajes

Los mensajes son las unidades individuales de comunicación dentro de una conversación. Pueden ser entrantes (del contacto), salientes (del equipo) o mensajes de actividad del sistema.

<AccordionGroup>
  <Accordion title="Tipos de mensajes">
    * **Incoming**: Mensajes recibidos del contacto
    * **Outgoing**: Mensajes enviados por el equipo
    * **Activity**: Mensajes del sistema (asignaciones, cambios de estado, etc.)
    * **Template**: Mensajes basados en plantillas (especialmente para WhatsApp)
  </Accordion>

  <Accordion title="Tipos de contenido">
    * **Text**: Mensaje de texto simple
    * **Cards**: Tarjetas interactivas con botones
    * **Form**: Formularios para recopilar información
    * **Article**: Artículos de la base de conocimiento
    * **Voice Call**: Llamadas de voz
    * **Input CSAT**: Encuestas de satisfacción
    * **Integrations**: Contenido de integraciones externas
  </Accordion>

  <Accordion title="Estados de entrega">
    * **Sent**: Mensaje enviado
    * **Delivered**: Mensaje entregado al destinatario
    * **Read**: Mensaje leído por el destinatario
    * **Failed**: Error en el envío
  </Accordion>
</AccordionGroup>

### Inboxes (Canales de comunicación)

Los inboxes son los canales a través de los cuales recibes y envías mensajes. Cada inbox está asociado a un tipo de canal específico.

## Canales disponibles

Yampi.ai soporta múltiples canales de comunicación para que puedas centralizar todas tus interacciones:

<CardGroup cols={3}>
  <Card title="WhatsApp" icon="message">
    Integración completa con WhatsApp API Cloud o Twilio.
  </Card>

  <Card title="Email" icon="envelope">
    Gestión de correo electrónico Gmail, Outlook y SMTP.
  </Card>

  <Card title="SMS" icon="message">
    Envío y recepción de mensajes SMS a través de Twilio.
  </Card>

  <Card title="Web Widget" icon="globe">
    Chat embebible en tu sitio web para atención en tiempo real.
  </Card>

  <Card title="Facebook" icon="facebook">
    Integración con páginas para gestionar mensajes y comentarios.
  </Card>

  <Card title="Instagram" icon="instagram">
    Gestión de mensajes directos de Instagram y respuestas a historias.
  </Card>

  <Card title="TikTok" icon="tiktok">
    Integración con TikTok para gestionar mensajes directos.
  </Card>

  <Card title="Voz" icon="phone">
    Llamadas de voz a través de Twilio para atención telefónica integrada.
  </Card>

  <Card title="API" icon="code">
    Canal programático para integrar sistemas externos mediante API.
  </Card>
</CardGroup>

## Características principales

### Asignación automática

El sistema puede asignar automáticamente conversaciones a miembros del equipo según reglas configurables:

* **Round Robin**: Distribución equitativa entre agentes disponibles
* **Límites de carga**: Control del número máximo de conversaciones por agente
* **Horarios de trabajo**: Asignación solo durante horas laborales
* **Priorización**: Asignación basada en prioridad de la conversación

<Tip>
  Configura límites de asignación para evitar sobrecargar a tus agentes y mantener tiempos de respuesta equilibrados.
</Tip>

### Gestión de estados y prioridades

Controla el flujo de trabajo mediante estados y prioridades:

<Steps>
  <Step title="Estados de conversación">
    Los estados te permiten organizar el trabajo:

    * **Open**: Conversaciones activas que requieren atención
    * **Resolved**: Conversaciones cerradas y resueltas
    * **Pending**: Esperando procesamiento (útil para bots)
    * **Snoozed**: Pausadas hasta una fecha específica
  </Step>

  <Step title="Prioridades">
    Asigna prioridades para gestionar la atención:

    * **Urgent**: Requiere atención inmediata
    * **High**: Alta prioridad
    * **Medium**: Prioridad normal
    * **Low**: Puede esperar
  </Step>
</Steps>

### Atributos personalizados

Añade información adicional a las conversaciones mediante atributos personalizados:

* Información específica del negocio
* Metadatos de propiedades relacionadas
* Etiquetas personalizadas
* Campos de seguimiento

<Info>
  Los atributos personalizados te permiten adaptar Yampi.ai a tus procesos específicos y mantener contexto relevante en cada conversación.
</Info>

### Etiquetas

Organiza y categoriza conversaciones con etiquetas:

* Filtrado rápido de conversaciones
* Segmentación para reportes
* Automatización basada en etiquetas
* Búsqueda avanzada

### Equipos

Agrupa conversaciones por equipos para una mejor organización:

* Distribución por departamentos
* Especialización por tipo de consulta
* Gestión de carga de trabajo por equipo

### Bots y automatización

Integra bots de agente para automatizar respuestas:

* **Agent Bots**: Bots configurados para responder automáticamente
* **Automatización de reglas**: Respuestas automáticas basadas en condiciones
* **Handoff a humanos**: Transferencia automática cuando el bot no puede resolver

<Warning>
  Los bots pueden manejar conversaciones iniciales, pero siempre debes tener un proceso para escalar a agentes humanos cuando sea necesario.
</Warning>

### Horarios de trabajo

Configura horarios de disponibilidad para cada inbox:

* Días y horas de atención
* Zonas horarias por inbox
* Mensajes fuera de oficina automáticos
* Respuestas diferidas fuera de horario

### Encuestas de satisfacción (CSAT)

Mide la satisfacción del cliente con encuestas configurables:

* Encuestas automáticas después de resolver conversaciones
* Métricas de satisfacción por agente
* Reportes de CSAT por período

### Auto-resolución

Las conversaciones pueden resolverse automáticamente después de un período de inactividad:

* Configuración por cuenta
* Basado en última actividad
* Notificaciones antes de resolver

## Integración con otros módulos

El módulo de comunicaciones se integra estrechamente con otros módulos de Yampi.ai:

<CardGroup cols={2}>
  <Card title="CRM" icon="users">
    Cada conversación está vinculada a un contacto, empresa u oportunidad, permitiendo ver historial completo.
  </Card>

  <Card title="Propiedades" icon="building">
    Asocia conversaciones con propiedades específicas para contexto inmobiliario completo.
  </Card>

  <Card title="Agentes IA" icon="robot">
    Los agentes de IA pueden participar en conversaciones, responder preguntas y gestionar consultas.
  </Card>

  <Card title="Webhooks" icon="webhook">
    Recibe notificaciones en tiempo real de eventos de conversación para integrar con sistemas externos.
  </Card>
</CardGroup>

## Mejores prácticas

<Tip>
  **Organización**: Usa etiquetas y atributos personalizados desde el inicio para mantener tus conversaciones organizadas y facilitar la búsqueda posterior.
</Tip>

<Tip>
  **Respuestas rápidas**: Crea respuestas predefinidas (canned responses) para consultas frecuentes y acelera el tiempo de respuesta.
</Tip>

<Tip>
  **Priorización**: Establece un sistema claro de prioridades y asegúrate de que tu equipo lo siga consistentemente.
</Tip>

<Warning>
  **Privacidad**: Los mensajes privados (notas internas) no son visibles para los contactos. Úsalos para comunicación interna del equipo.
</Warning>

## Próximos pasos

<CardGroup cols={2}>
  <Card title="API de Comunicaciones" icon="code" href="/api-reference/introduction">
    Integra el módulo de comunicaciones con tus sistemas mediante la API de Yampi.ai.
  </Card>

  <Card title="Configuración de Inboxes" icon="gear" href="/api-reference/introduction">
    Aprende a configurar y gestionar canales de comunicación.
  </Card>
</CardGroup>