NicoChatNicoChatDocumentaçãoBuscar na documentação…
Entrar
Canais/WhatsApp/WhatsApp QR Code/Evolution API - WhatsApp QR Code

Evolution API - WhatsApp QR Code

Este documento detalha o processo de integração entre o NicoChat e a Evolution API, destacando-se por ser uma solução self-hosted e gratuita, o que permite uma gestão completa no seu próprio servidor sem custos adicionais por instância.

2026-08-12
Atenção
Salientamos que este documento não abrange a instalação da Evolution API em seu servidor nem detalha os processos de configuração inicial de sistemas self-hosted.
Dica
Para usuários ou desenvolvedores interessados em aprofundar seus conhecimentos sobre a implementação e conexão de sistemas self-hosted em servidores próprios, recomendamos o curso Promova Web. Este curso é uma excelente fonte de aprendizado, abordando desde conceitos fundamentais até práticas avançadas necessárias para o sucesso de suas implantações self-hosted. Veja detalhes desse curso aqui: go.hotmart.com/N89540098A

Guia de Integração do NicoChat com Evolution API

Este documento detalha o processo de integração entre o NicoChat e a Evolution API, destacando-se por ser uma solução self-hosted e gratuita, o que permite uma gestão completa no seu próprio servidor sem custos adicionais por instância. A integração com a Evolution API abre um leque de possibilidades para automações e comunicações via WhatsApp diretamente do seu servidor.

Pré-requisitos

Antes de iniciar a integração, é essencial que a Evolution API já esteja instalada e configurada em seu servidor. Você deve ter:

  • O domínio da sua instância da Evolution API.
  • O nome da instância criada dentro da Evolution API.
  • A chave API específica para a instância.
  • O número de telefone WhatsApp vinculado à instância.

Esses dados são cruciais para a integração com o NicoChat, pois cada instância da Evolution API funcionará de forma independente dentro do seu ambiente de automação.

Configuração no NicoChat

Para integrar o NicoChat com a sua instância da Evolution API, siga os passos abaixo:

  • Acesso ao NicoChat: Entre na plataforma do NicoChat e localize a aba WhatsApp QR Code.
  • Adição de Novo Bot: Selecione a opção para adicionar um novo bot e escolha a Evolution API como tipo de serviço a ser integrado.
Atenção
Verifique a versão da sua Evolution API para selecionar corretamente entre a V1 (até a 1.8.3) e a V2 (a partir da 2.0.0).
  • Preenchimento dos Dados: Insira as informações coletadas (domínio da API, nome da instância, chave API e número do WhatsApp) nos campos apropriados.
Atenção
O Nome da Instância não pode conter caracteres especiais como espaço, Ç, Ã, etc.

Ao completar esses passos, a integração entre o NicoChat e a Evolution API será estabelecida, permitindo o início da automação das suas comunicações via WhatsApp.

Armazenamento de Mídia

A Evolution API não armazena automaticamente mídias (imagens, áudios, documentos, vídeos) enviadas pelos usuários finais para o seu WhatsApp. Se desejar manter um registro dessas mídias dentro do seu chatbot no NicoChat, será necessário integrar um serviço de armazenamento externo, como o S3 Storage da Amazon.

Conectando com o S3 Storage

Para configurar o armazenamento de mídia com o S3 Storage, é recomendável seguir as instruções disponíveis na documentação oficial de conexão com o S3 Storage. Este processo garantirá que todas as mídias recebidas pelo seu chatbot sejam armazenadas de forma segura e acessível.

Para detalhes sobre a configuração do S3 Storage: S3 Storage

Notas Finais

A integração do NicoChat com a Evolution API proporciona uma solução poderosa e econômica para a automação de mensagens via WhatsApp, com o benefício adicional de ser completamente gerenciável em seu próprio ambiente de servidor. Lembre-se de que, para um funcionamento pleno, pode ser necessário ajustar configurações de acordo com suas necessidades específicas, especialmente no que diz respeito ao armazenamento de mídia.