Guia básico de integração - Envio e recebimento de mensagens Omnichannel 3C Plus | 3C Plus | Help Center

Guia básico de integração - Envio e recebimento de mensagens Omnichannel 3C Plus

Veja como integrar com o Omnichannel 3C Plus para enviar e receber mensagens.

O primeiro passo para garantir o envio e recebimento de mensagens funcione é se certificar se você tem um canal conectada dentro da plataforma 3C Plus.

Para garantir o correto envio e recebimento de mensagens, siga os passos abaixo para conectar seu canal na plataforma 3C Plus:
​

Passo 1: Acesse a plataforma

Realize o login na plataforma 3C Plus com suas credenciais.

Passo 2: Crie um grupo de canais

No menu Omnichannel, clique em Novo Grupo de Canais e crie o grupo desejado.
​

​

Passo 3: Adicione um canal WhatsApp

Após criar o grupo de canais, adicione uma conexão do WhatsApp. Você pode escolher entre WhatsApp 3C+ ou WhatsApp API Oficial - WABA clicando em Novo Canal.
​

Passo 4: Autentique seu canal

Dependendo do tipo de canal selecionado, siga o processo de autenticação correspondente:

• Para WhatsApp 3C+, basta escanear o QR Code com o aplicativo do WhatsApp.

• Para WhatsApp API Oficial - WABA, será necessário seguir o processo de conexão com a Meta, conforme as diretrizes da plataforma.

Para WhatsApp 3C+, basta escanear o QR Code com o aplicativo do WhatsApp.

Para WhatsApp API Oficial - WABA, será necessário seguir o processo de conexão com a Meta, conforme as diretrizes da plataforma.

Com o canal devidamente conectado, o envio e recebimento de mensagens estará disponível para uso.
​

Integracão

Envio de mensagens

Para realizar o envio de mensagens no Omnichannel, é fundamental compreender alguns conceitos e estruturas básicas:

• Grupos de Canais: Agrupam diferentes canais (instâncias) dentro da plataforma.

• Canais: São as instâncias específicas de comunicação, como o WhatsApp 3C+ ou Whatsapp API Oficial - WABA.

• Chats: Cada canal possui diversos chats, que representam as conversas iniciadas por clientes ou operadores.

• Mensagens: Dentro dos chats, temos as mensagens individuais trocadas entre os participantes da conversa.

Grupos de Canais: Agrupam diferentes canais (instâncias) dentro da plataforma.

Canais: São as instâncias específicas de comunicação, como o WhatsApp 3C+ ou Whatsapp API Oficial - WABA.

Chats: Cada canal possui diversos chats, que representam as conversas iniciadas por clientes ou operadores.

Mensagens: Dentro dos chats, temos as mensagens individuais trocadas entre os participantes da conversa.

Compreender essa hierarquia é essencial para garantir uma integração eficiente no processo de envio e recebimento de mensagens.

Para o envio de uma mensagem é preciso existe um chat aberto com o numero de destinatario da mesma, isso é feito com essa requisicão

• instance_id: O ID da instância do WhatsApp.

• number: O número do destinatário com quem o chat será aberto.

instance_id: O ID da instância do WhatsApp.

number: O número do destinatário com quem o chat será aberto.

Para obter o instance_id necessario para abrir o chat, basta enviar uma requisição para a seguinte rota:

• Dentro da resposta, acesse o objeto company e, em seguida, a chave instances.data, essa chave contém uma lista de instâncias disponíveis (canais), e cada instância terá um id. Esse ID é essencial para operações como abertura de chats e envio de mensagens, representando canais como o WhatsApp.

Dentro da resposta, acesse o objeto company e, em seguida, a chave instances.data, essa chave contém uma lista de instâncias disponíveis (canais), e cada instância terá um id. Esse ID é essencial para operações como abertura de chats e envio de mensagens, representando canais como o WhatsApp.

Agora que o chat está aberto, você pode enviar mensagens de texto para ele utilizando a seguinte requisição:

Além do envio de mensagens de texto, a API permite o envio de diversos outros tipos de mensagens no WhatsApp, como imagens, áudios, vídeos, documentos e até mensagens internas. Acesse nossa documentação completa e confira todos os detalhes e exemplos de uso!

Recebimento de Mensagens

Para receber mensagens em tempo real na plataforma 3C Plus, é necessário conectar ao serviço de Socket.IO, que permite receber notificações instantâneas de novos eventos, como o recebimento de mensagens no WhatsApp.

Abaixo está um exemplo de como estabelecer essa conexão:

​

Evento de Recebimento de Mensagens

Para capturar as mensagens recebidas, você precisa escutar o evento específico de nova mensagem:

Toda vez que uma nova mensagem for recebida no canal WhatsApp, o evento "new-message-whatsapp" será disparado, contendo todas as informações da mensagem no objeto event.

​

Listagem de Mensagens

Além do uso do Socket.IO para receber mensagens em tempo real, também é possível listar facilmente as mensagens de um chat específico utilizando o seguinte endpoint da API:

Conclusão

Para garantir uma integração eficaz com a plataforma 3C Plus, é essencial seguir todos os passos, desde a conexão do canal até o envio e recebimento de mensagens.

Ao conectar o canal do WhatsApp, você pode realizar diversas operações, como abrir novos chats, enviar mensagens em diferentes formatos (texto, imagem, áudio, vídeo, etc.) e receber mensagens em tempo real via Socket.IO. Cada um desses elementos — canais, instâncias, chats e mensagens — tem um papel importante no fluxo de comunicação da plataforma.
​

Além disso, a API da 3C Plus permite a listagem de mensagens de forma simples, garantindo flexibilidade no monitoramento das conversas. Para explorar todas as funcionalidades, recomendamos acessar a documentação completa da plataforma, onde você encontrará mais exemplos e informações detalhadas para garantir uma integração perfeita.
​

Visite a documentação para obter mais informações e aproveitar ao máximo todos os recursos que a 3C Plus oferece!