O Evolution Channel é um canal universal de integração que permite a entrada de mensagens através de webhooks, proporcionando flexibilidade para conectar diversos sistemas e aplicativos com a Evolution API. Este canal facilita a automação e o gerenciamento de mensagens, suportando diversas integrações e fluxos de trabalho.
Para configurar uma instância no Evolution Channel, você precisará acessar a rota /instance/create
da Evolution API com o seguinte corpo de requisição:
Endpoint
Corpo da Requisição
Aqui está um exemplo de como criar uma instância no Evolution Channel:
instanceName
: Nome da instância que você está criando.token
: Token opcional para autenticar a instância.number
: Number ID da instância que será utilizado para receber e enviar mensagens.qrcode
: Defina como false
pois a integração não requer QR Code.integration
: Use "EVOLUTION"
para especificar que esta integração é com o canal universal Evolution.Exemplo de Requisição
Após a criação da instância, o Evolution Channel receberá as mensagens enviadas para a instância configurada. Essas mensagens são enviadas para a rota {baseUrl}/webhook/evolution
como requisições POST. Este é o ponto de entrada para as mensagens que o Evolution Channel irá processar.
URL do Webhook para Entrada de Mensagens
Aqui está um exemplo do formato de payload enviado para o Evolution Channel quando uma mensagem é recebida:
numberId
: ID do número cadastrado na criação da instância.key.remoteJid
: Número ou ID único do contato que enviou a mensagem.key.fromMe
: Indica se a mensagem foi enviada pelo contato (false
) ou pelo próprio sistema (true
).key.id
: ID único da mensagem.pushName
: Nome do contato que enviou a mensagem.message.conversation
: Conteúdo da mensagem recebida.messageType
: Tipo da mensagem (neste caso, conversation
).O Evolution Channel envia feedback e postbacks através dos canais de eventos configurados, como webhooks, RabbitMQ, ou SQS. Isso permite que você receba notificações em tempo real sobre o status das mensagens e interações, mantendo seu sistema atualizado.
Exemplos de Canais de Eventos
Configuração de Canais de Eventos Para configurar os canais de eventos, defina os parâmetros necessários no seu arquivo de configuração ou diretamente na instância, conforme as especificações da Evolution API.
Com a instância criada e a configuração do webhook de entrada de mensagens, a sua Evolution API está pronta para operar com o Evolution Channel. Todas as mensagens recebidas e os eventos associados serão gerenciados de forma centralizada, permitindo uma integração fluida e eficiente com seus sistemas de mensagens e automação.
Esta documentação fornece uma visão clara e detalhada de como integrar o Evolution Channel com a Evolution API, desde a criação da instância até a configuração dos webhooks e canais de eventos. Seguindo estas etapas, você estará preparado para utilizar o canal universal Evolution em sua aplicação.
O Evolution Channel é um canal universal de integração que permite a entrada de mensagens através de webhooks, proporcionando flexibilidade para conectar diversos sistemas e aplicativos com a Evolution API. Este canal facilita a automação e o gerenciamento de mensagens, suportando diversas integrações e fluxos de trabalho.
Para configurar uma instância no Evolution Channel, você precisará acessar a rota /instance/create
da Evolution API com o seguinte corpo de requisição:
Endpoint
Corpo da Requisição
Aqui está um exemplo de como criar uma instância no Evolution Channel:
instanceName
: Nome da instância que você está criando.token
: Token opcional para autenticar a instância.number
: Number ID da instância que será utilizado para receber e enviar mensagens.qrcode
: Defina como false
pois a integração não requer QR Code.integration
: Use "EVOLUTION"
para especificar que esta integração é com o canal universal Evolution.Exemplo de Requisição
Após a criação da instância, o Evolution Channel receberá as mensagens enviadas para a instância configurada. Essas mensagens são enviadas para a rota {baseUrl}/webhook/evolution
como requisições POST. Este é o ponto de entrada para as mensagens que o Evolution Channel irá processar.
URL do Webhook para Entrada de Mensagens
Aqui está um exemplo do formato de payload enviado para o Evolution Channel quando uma mensagem é recebida:
numberId
: ID do número cadastrado na criação da instância.key.remoteJid
: Número ou ID único do contato que enviou a mensagem.key.fromMe
: Indica se a mensagem foi enviada pelo contato (false
) ou pelo próprio sistema (true
).key.id
: ID único da mensagem.pushName
: Nome do contato que enviou a mensagem.message.conversation
: Conteúdo da mensagem recebida.messageType
: Tipo da mensagem (neste caso, conversation
).O Evolution Channel envia feedback e postbacks através dos canais de eventos configurados, como webhooks, RabbitMQ, ou SQS. Isso permite que você receba notificações em tempo real sobre o status das mensagens e interações, mantendo seu sistema atualizado.
Exemplos de Canais de Eventos
Configuração de Canais de Eventos Para configurar os canais de eventos, defina os parâmetros necessários no seu arquivo de configuração ou diretamente na instância, conforme as especificações da Evolution API.
Com a instância criada e a configuração do webhook de entrada de mensagens, a sua Evolution API está pronta para operar com o Evolution Channel. Todas as mensagens recebidas e os eventos associados serão gerenciados de forma centralizada, permitindo uma integração fluida e eficiente com seus sistemas de mensagens e automação.
Esta documentação fornece uma visão clara e detalhada de como integrar o Evolution Channel com a Evolution API, desde a criação da instância até a configuração dos webhooks e canais de eventos. Seguindo estas etapas, você estará preparado para utilizar o canal universal Evolution em sua aplicação.