1. Prepare o servidor
Use um servidor Linux com Docker Compose instalado, domínio apontado e HTTPS por proxy reverso.
Para TI e desenvolvimento
Instale e opere o talk.io na sua infraestrutura
Este guia é para quem administra servidores, domínios e integrações. Para quem atende clientes, basta entrar no talk.io e começar a trabalhar.
2. Baixe e configure
Copie o repositório, gere os segredos no arquivo .env e informe o endereço público da instalação.
3. Suba os serviços
O Docker inicia talk.io, banco de dados, gateway de WhatsApp e os volumes persistentes.
4. Entregue para a operação
A primeira pessoa cria a empresa e vira administradora. Depois, a equipe trabalha pelo painel.
Instalação com Docker
No servidor, execute os comandos abaixo e preencha os segredos solicitados no arquivo .env.
git clone https://github.com/fillipearaujo92/talkio.git
cd talkio
cp .env.docker.example .env
# edite o .env e gere os segredos com: openssl rand -hex 32
docker compose up -dObrigatório: defina as senhas dos bancos, a chave do ELO e o segredo de webhook.
Recomendado: coloque HTTPS por proxy reverso e ajuste TALKIO_PUBLIC_URL para o domínio público.
Instagram: mensagens e comentários
Defina INSTAGRAM_APP_ID, INSTAGRAM_APP_SECRET e INSTAGRAM_VERIFY_TOKEN no .env. No painel da Meta, cadastre o webhook em /api/webhooks/instagram assinando os campos messages e comments.
É um aplicativo para todas as empresas do servidor: cada cliente só autoriza a própria conta, e o token dela fica separado. Para atender contas de terceiros, a Meta exige a condição de Tech Provider, além da verificação da empresa e da revisão com Acesso Avançado — algo entre duas e quatro semanas. Com o aplicativo em desenvolvimento, o fluxo inteiro já funciona nas contas que você administra.
Vídeo em 4G e redes corporativas
Configure TURN com TURN_HOST, TURN_EXTERNAL_IP e TURN_SECRET. Libere as portas indicadas no arquivo de ambiente.
Operação diária
A primeira conta é administradora. Configure canais no painel, convide a equipe e preserve os volumes Docker nos backups.