RabbitMQ

La Evolution API permite la integración con RabbitMQ para gestionar eventos y colas de mensajes, facilitando la comunicación y el procesamiento de tareas de forma eficiente y escalable. A continuación, encontrará información sobre cómo configurar RabbitMQ tanto en modo global como en instancias individuales.

Configuración Global de RabbitMQ

Con la nueva configuración global, es posible centralizar el procesamiento de eventos en colas unificadas, en lugar de configurar colas separadas para cada instancia. Esto simplifica la gestión de eventos, ya que todos los eventos del sistema pasan por colas específicas de acuerdo con el tipo de evento.

Configuración de Variables de Entorno

Aquí están las variables de entorno necesarias para habilitar y configurar RabbitMQ en modo global:

RABBITMQ_ENABLED=true
RABBITMQ_URI=amqp://admin:admin@localhost:5672/default
RABBITMQ_EXCHANGE_NAME=evolution_exchange
RABBITMQ_GLOBAL_ENABLED=true

Eventos Configurables

Con el modo global habilitado (RABBITMQ_GLOBAL_ENABLED=true), todos los eventos se encolan en colas específicas por tipo de evento, en lugar de por instancia. Aquí está la lista de eventos que puede activar globalmente:

RABBITMQ_EVENTS_APPLICATION_STARTUP=true
RABBITMQ_EVENTS_INSTANCE_CREATE=true
RABBITMQ_EVENTS_INSTANCE_DELETE=true
RABBITMQ_EVENTS_QRCODE_UPDATED=true
RABBITMQ_EVENTS_MESSAGES_SET=true
RABBITMQ_EVENTS_MESSAGES_UPSERT=true
RABBITMQ_EVENTS_MESSAGES_EDITED=true
RABBITMQ_EVENTS_MESSAGES_UPDATE=true
RABBITMQ_EVENTS_MESSAGES_DELETE=true
RABBITMQ_EVENTS_SEND_MESSAGE=true
RABBITMQ_EVENTS_CONTACTS_SET=true
RABBITMQ_EVENTS_CONTACTS_UPSERT=true
RABBITMQ_EVENTS_CONTACTS_UPDATE=true
RABBITMQ_EVENTS_PRESENCE_UPDATE=true
RABBITMQ_EVENTS_CHATS_SET=true
RABBITMQ_EVENTS_CHATS_UPSERT=true
RABBITMQ_EVENTS_CHATS_UPDATE=true
RABBITMQ_EVENTS_CHATS_DELETE=true
RABBITMQ_EVENTS_GROUPS_UPSERT=true
RABBITMQ_EVENTS_GROUP_UPDATE=true
RABBITMQ_EVENTS_GROUP_PARTICIPANTS_UPDATE=true
RABBITMQ_EVENTS_CONNECTION_UPDATE=true
RABBITMQ_EVENTS_CALL=true
RABBITMQ_EVENTS_TYPEBOT_START=true
RABBITMQ_EVENTS_TYPEBOT_CHANGE_STATUS=true

Funcionamiento

Cola por Evento: En el modo global, los eventos se encolan en colas específicas para cada tipo de evento. Por ejemplo, todos los eventos de actualización de mensajes (MESSAGES_UPDATE) se encolarán en la misma cola, independientemente de la instancia de origen.
Facilidad de Gestión: Este enfoque facilita la gestión y el monitoreo de los eventos, permitiendo una centralización de las operaciones y simplificando la lógica de consumo de mensajes en su sistema.

Configuración de RabbitMQ para Instancias Individuales

Aunque la configuración global es recomendada para centralizar el procesamiento de eventos, todavía es posible configurar RabbitMQ para instancias individuales, en caso de que sea necesaria la segmentación por instancia.

Endpoint para Configuración Individual

Para configurar RabbitMQ para una instancia específica de WhatsApp en la Evolution API, utilice el siguiente endpoint:

POST [baseUrl]/rabbitmq/set/[instance_name]

Cuerpo de la Solicitud

Aquí hay un ejemplo del cuerpo JSON para configurar eventos en una instancia específica:

{
    "enabled": true,
    "events": [
        "APPLICATION_STARTUP",
        "QRCODE_UPDATED",
        "MESSAGES_SET",
        "MESSAGES_UPSERT",
        "MESSAGES_UPDATE",
        "MESSAGES_DELETE",
        "SEND_MESSAGE",
        "CONTACTS_SET",
        "CONTACTS_UPSERT",
        "CONTACTS_UPDATE",
        "PRESENCE_UPDATE",
        "CHATS_SET",
        "CHATS_UPSERT",
        "CHATS_UPDATE",
        "CHATS_DELETE",
        "GROUPS_UPSERT",
        "GROUP_UPDATE",
        "GROUP_PARTICIPANTS_UPDATE",
        "CONNECTION_UPDATE",
        "CALL",
        "NEW_JWT_TOKEN"
    ]
}

Elimine los eventos no utilizados para optimizar el uso de recursos de RabbitMQ.

Al configurar la integración con RabbitMQ para instancias individuales, ajuste el array de eventos en el cuerpo JSON para incluir solo los eventos relevantes para esa instancia.

Consideraciones Finales

La configuración de RabbitMQ en la Evolution API ofrece flexibilidad para gestionar eventos de forma centralizada con la configuración global, o de forma segmentada por instancia, dependiendo de las necesidades de su sistema. Utilice la configuración global para simplificar la gestión de eventos en entornos complejos, o configure individualmente para un control más granular.

Para más detalles sobre las variables de entorno de RabbitMQ y otras configuraciones avanzadas, consulte la sección de variables de entorno.

Primeros Pasos

Configuración

Integraciones

Configuración Global de RabbitMQ

Configuración de Variables de Entorno

Eventos Configurables

Funcionamiento

Configuración de RabbitMQ para Instancias Individuales

Endpoint para Configuración Individual

Cuerpo de la Solicitud

Consideraciones Finales

​Configuración Global de RabbitMQ

​Configuración de Variables de Entorno

​Eventos Configurables

​Funcionamiento

​Configuración de RabbitMQ para Instancias Individuales

​Endpoint para Configuración Individual

​Cuerpo de la Solicitud

​Consideraciones Finales

Configuración Global de RabbitMQ

Configuración de Variables de Entorno

Eventos Configurables

Funcionamiento

Configuración de RabbitMQ para Instancias Individuales

Endpoint para Configuración Individual

Cuerpo de la Solicitud

Consideraciones Finales