1. Configuração da Instância Evolution
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:
Criação da Instância
EndpointParâmetros do Corpo da Requisição
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 comofalse
pois a integração não requer QR Code.integration
: Use"EVOLUTION"
para especificar que esta integração é com o canal universal Evolution.
2. Entrada de Mensagens no Evolution Channel
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
Exemplo de Payload de Entrada de Mensagem
Aqui está um exemplo do formato de payload enviado para o Evolution Channel quando uma mensagem é recebida:Explicação dos Campos do Payload
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
).
3. Feedback e Postbacks
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- Webhook: Notificações são enviadas para um endpoint HTTP especificado.
- RabbitMQ: Mensagens são enviadas para uma fila RabbitMQ configurada.
- SQS: Mensagens são enviadas para uma fila SQS da AWS.