Skip to main content
Evolution Channel es un canal universal de integración que permite la entrada de mensajes a través de webhooks, proporcionando flexibilidad para conectar diversos sistemas y aplicaciones con la Evolution API. Este canal facilita la automatización y la gestión de mensajes, soportando diversas integraciones y flujos de trabajo.

​
1. Configuración de la Instancia Evolution

Para configurar una instancia en Evolution Channel, necesitará acceder a la ruta /instance/create de la Evolution API con el siguiente cuerpo de solicitud:

​
Creación de la Instancia

Endpoint
Cuerpo de la Solicitud Aquí hay un ejemplo de cómo crear una instancia en Evolution Channel:

​
Parámetros del Cuerpo de la Solicitud

  • instanceName: Nombre de la instancia que está creando.
  • token: Token opcional para autenticar la instancia.
  • number: Number ID de la instancia que será utilizado para recibir y enviar mensajes.
  • qrcode: Defina como false ya que la integración no requiere QR Code.
  • integration: Use "EVOLUTION" para especificar que esta integración es con el canal universal Evolution.
Ejemplo de Solicitud

​
2. Entrada de Mensajes en Evolution Channel

Después de la creación de la instancia, Evolution Channel recibirá los mensajes enviados a la instancia configurada. Estos mensajes se envían a la ruta {baseUrl}/webhook/evolution como solicitudes POST. Este es el punto de entrada para los mensajes que Evolution Channel procesará. URL del Webhook para Entrada de Mensajes

​
Ejemplo de Payload de Entrada de Mensaje

Aquí hay un ejemplo del formato de payload enviado a Evolution Channel cuando se recibe un mensaje:

​
Explicación de los Campos del Payload

  • numberId: ID del número registrado en la creación de la instancia.
  • key.remoteJid: Número o ID único del contacto que envió el mensaje.
  • key.fromMe: Indica si el mensaje fue enviado por el contacto (false) o por el propio sistema (true).
  • key.id: ID único del mensaje.
  • pushName: Nombre del contacto que envió el mensaje.
  • message.conversation: Contenido del mensaje recibido.
  • messageType: Tipo del mensaje (en este caso, conversation).

​
3. Feedback y Postbacks

Evolution Channel envía feedback y postbacks a través de los canales de eventos configurados, como webhooks, RabbitMQ o SQS. Esto permite que reciba notificaciones en tiempo real sobre el estado de los mensajes e interacciones, manteniendo su sistema actualizado. Ejemplos de Canales de Eventos
  • Webhook: Las notificaciones se envían a un endpoint HTTP especificado.
  • RabbitMQ: Los mensajes se envían a una cola RabbitMQ configurada.
  • SQS: Los mensajes se envían a una cola SQS de AWS.
Configuración de Canales de Eventos Para configurar los canales de eventos, defina los parámetros necesarios en su archivo de configuración o directamente en la instancia, conforme las especificaciones de la Evolution API.

​
Conclusión

Con la instancia creada y la configuración del webhook de entrada de mensajes, su Evolution API está lista para operar con Evolution Channel. Todos los mensajes recibidos y los eventos asociados serán gestionados de forma centralizada, permitiendo una integración fluida y eficiente con sus sistemas de mensajería y automatización. Esta documentación proporciona una visión clara y detallada de cómo integrar Evolution Channel con la Evolution API, desde la creación de la instancia hasta la configuración de los webhooks y canales de eventos. Siguiendo estas etapas, estará preparado para utilizar el canal universal Evolution en su aplicación.