Atualização KiraGo Versão 1.8.1

O que há de novo 🚀

KiraGo 1.8.1 — Motor WhatsApp atualizado (LID), passkey no painel e /user/check com número PN

Principais melhorias

• Motor WhatsApp atualizado — envio de DM mais estável (LID), checagem de número melhorada e reject de chamada corrigido.
• Passkey no painel — se o WhatsApp pedir verificação após o QR, o modal aparece sozinho (autenticar / confirmar código). QR e código por telefone não mudam.
• POST /user/check — passa a devolver PhoneNumber (número @s.whatsapp.net) quando o JID vier como @lid.

---

Novidades ✅

Motor WhatsApp

• Envio de DM — entrega alinhada ao modelo atual do WhatsApp (LID).
• /user/check — campo PhoneNumber na resposta quando disponível.
• Reject de chamada — rejeite automático e POST /call/reject mais confiáveis.

Painel — passkey

• Modal automático quando o WhatsApp pedir passkey após o QR.
• Botão Autenticar com passkey e Confirmar pareamento com o código mostrado no celular.

API

• POST /user/check — Users[].PhoneNumber (opcional); JID pode ser @lid.
• Documentação em /api atualizada.

Correções 🔧

• Badge de atualização no painel — aviso de nova versão mais preciso (sem falso “atualize” quando você já está na última).

Como atualizar ♻️

docker pull ggdadds/kirago:1.8.1
# ou
docker pull ggdadds/kirago:latest

Atualização KiraGo Versão 1.8

O que há de novo 🚀

KiraGo 1.8 — Pareamento passkey, motor WhatsApp atualizado e instância com pool Webshare em um passo

Principais melhorias

• Pareamento por passkey (WebAuthn) — suporte ao novo fluxo do WhatsApp além do QR; API e webhooks para integrar no seu front-end.
• Motor WhatsApp (whatsmeow) atualizado — proto mais recente, pareamento QR mais estável e preparação para contas que exigem passkey.
• Criar instância já com pool Webshare — em um único POST /admin/users com webshareConfig; o sistema escolhe um IP livre do pool na hora.
• Documentação Swagger (/api) — endpoints de pools Webshare, proxy por instância e passkey documentados no painel API.

---

Novidades ✅

Pareamento passkey

• API — GET /session/passkey, POST /session/passkey/response, POST /session/passkey/confirm.
• Webhooks — PairPasskeyRequest, PairPasskeyConfirmation, PairPasskeyError (assináveis como os demais eventos).
• Status — GET /session/status inclui campo passkey com a fase atual (request, confirmation ou vazio).
• Fluxo QR tradicional continua igual; passkey é caminho alternativo quando o WhatsApp solicitar.

Proxy Webshare — criação de instância

• POST /admin/users aceita webshareConfig: { "enabled": true, "pool_id": "..." } — vincula pool e proxy na criação (sem 3º passo).
• Painel — Nova instância: ao ativar proxy, escolha Pool Webshare (recomendado) ou URL manual; lista os pools cadastrados pelo admin.
• Não use proxyConfig e webshareConfig juntos na mesma requisição.

API / Swagger (/api)

• Admin — GET/POST /admin/proxy/webshare/pools, PUT/DELETE /admin/proxy/webshare/pools/{id}.
• Sessão — GET /session/proxy/pool-config, POST /session/proxy/webshare.
• Passkey — rotas de pareamento documentadas com exemplos.
• POST /admin/users — descrição e exemplo atualizados para webshareConfig.

Motor WhatsApp

• Atualização para whatsmeow com suporte a passkeys e proto v1042386815.
• Evento NotifyAccountReachoutTimelock — alerta de restrição/timelock da conta (webhook).
• Pareamento QR: ignora connect success antes do pairing concluir (mais estável).
• Log de PairSuccess passa a incluir LID.

---

Correções 🔧

• Chatwoot — evita criar várias caixas de entrada ao receber mensagens (reutiliza inbox existente; não recria em erro de rede).
• Botões com imagem — título no header, ViewOnce desligado em botões (evita sumir título / travar WhatsApp Web).
• Download de imagem em botões — contorna bloqueio 403 de CDN no envio server-side.
• Modal de licença — PIX visível para renovação antecipada; QR some após confirmação do pagamento; modal com rolagem em telas menores.

Melhorias gerais ♻️

• Helper interno applyWebsharePoolToUser — mesma lógica de atribuição de IP na criação da instância e em POST /session/proxy/webshare.
• README e exemplos de API alinhados ao fluxo pool → instância em um ou dois passos.

Atualização KiraGo Versão 1.7

O que há de novo 🚀

KiraGo 1.7 — Observação por instância, múltiplos webhooks, pools Webshare e painel renovado

Principais melhorias

• Observação interna em cada instância (cliente, proxy, lembrete, etc.) — só no painel, não vai pro WhatsApp.
• Vários webhooks por instância — cada um com nome, URL, eventos e status ativo/pausado; o WhatsApp assina a união dos eventos de todos os webhooks ativos.
• Pools Webshare nomeados (admin) — cadastre várias contas Webshare no painel; cada instância escolhe qual pool usar no modal de Proxy.
• Painel reorganizado — lista de instâncias e página interna da instância; card Webhooks com resumo; modal Gerenciar Webhooks (lista, criar, editar, pausar, excluir).

---

Novidades ✅

Observação por instância

• Chip Nota e prévia no card da lista quando houver texto.
• Ferramentas → Observação dentro da instância para editar.
• Campo opcional na aba Essencial ao criar nova instância.

Webhooks (multi)

• API — GET/POST /webhooks e PUT/DELETE /webhooks/{id} (header token da instância).
• Cada webhook: name, url, events[], active (pausar sem apagar).
• Compatibilidade: rotas legadas GET/POST/PUT/DELETE /webhook continuam no webhook Principal (migrado automaticamente do campo único antigo).
• Disparo: cada evento vai para todas as URLs ativas que assinam aquele tipo; retry na outbox por URL.
• Painel: chips de eventos, atalhos (Mensagens, Conexão, Todos, Limpar), botões Salvar/Cancelar fixos no rodapé do modal.

Proxy — pools Webshare (admin)

• API admin — GET/POST /admin/proxy/webshare/pools, PUT/DELETE /admin/proxy/webshare/pools/{id}.
• Vários pools com nome e API key; esquema HTTP/SOCKS5 por pool.
• Por instância: GET /session/proxy/pool-config e POST /session/proxy/webshare com pool_id.
• Painel admin: modal Pools Webshare na lista de instâncias (criar, editar, trocar key, remover).
• Rotas legadas GET/POST /admin/proxy/webshare mantidas.

Correções 🔧

• Crash concurrent map read and map write com várias requisições em paralelo no painel da instância.
• Card Webhooks não fica mais preso em Carregando… a cada poll de status.
• Modal de webhooks — rolagem e botões Salvar / Adicionar sempre visíveis.

Melhorias gerais ♻️

• Documentação README atualizada (multi-webhook + pools).

---

Atualização KiraGo Versão 1.6

O que há de novo 🚀

KiraGo 1.6 — Mais estável no WhatsApp, painel mais completo e proxy Webshare integrado

Principais melhorias

• Grupos e mensagens mais estáveis — promover, remover, adicionar participantes e enviar texto simples deixam de derrubar a sessão com tanta frequência.
• Versão visível no painel — número da versão na barra superior; aviso quando existe atualização mais nova; modal com novidades ao entrar no dashboard.
• Proxy Webshare no painel — configure só com a API key; o sistema escolhe o proxy; opção de compartilhar o pool entre instâncias sem repetir o mesmo IP ao mesmo tempo.
• Avatares das instâncias — fotos aparecem nos cards mesmo com proxy ativo; atualização automática após reiniciar o servidor.
• Cards mais informativos — selos (chips) mostram integrações ativas: Proxy, Webhook, Chatwoot, CRM, etc.

---

Novidades ✅

• Badge de versão na navbar do dashboard (ao lado do botão API).
• Aviso de atualização quando uma versão mais nova está disponível (com link para as notas).
• Modal de novidades ao logar no painel (uma vez por sessão do navegador).
• Proxy Webshare no modal de Proxy de cada instância:
  • Modo pool (só API key) ou manual (host/porta/usuário).
  • Compartilhar pool com outras instâncias da mesma instalação.
  • Forçar rotação para trocar de IP no pool.
• Avatares carregados automaticamente nas instâncias conectadas.
• Chips de integração nos cards (Proxy, Webhook, Chatwoot, Typebot, CRM, RabbitMQ, S3, HMAC).
• API de proxy Webshare — POST /session/proxy/webshare e GET /session/proxy/pool-config (para automações que preferem API em vez do painel).
• Motor WhatsApp atualizado — melhor compatibilidade com o protocolo atual do WhatsApp Web.

Correções 🔧

• Desconexão ao gerenciar grupos (adicionar, remover, promover, renomear, sair) — a sessão aguarda mais tempo a reconexão em vez de cair na hora.
• Texto simples rejeitado pelo WhatsApp — mensagens de texto sem link deixam de ser enviadas com tipo errado (media/url).
• Avatares sumindo no painel — especialmente quem usa proxy; imagens passam a carregar pelo servidor da instância.
• Filtro de instâncias no painel admin — não fica mais escondido atrás dos cards.
• Modal de proxy — interruptor não desliga sozinho ao abrir; lista de instâncias fonte do pool carrega corretamente.
• Modal de novidades da versão — rolagem e botões visíveis em telas menores.
• Grupos com JID inválido — uso de número sem @g.us em rotas de grupo passa a retornar erro claro em vez de derrubar a conexão.
• Mensagem mais clara ao reconectar — em alguns casos de instabilidade, a API responde pedindo para tentar de novo em alguns segundos (em vez de erro genérico).

Melhorias gerais ♻️

• Painel mais rápido para identificar o que cada instância tem configurado (chips + avatares).
• Reconexão após falhas de rede mais tolerante em operações demoradas.

---

Atualização KiraGo Versão 1.5

Atualização KiraGo (Webhook global + documentação) — Versão 1.5

Release focada em controle fino de eventos no webhook global e em documentação de eventos em português no README, para operação e integração mais previsíveis.

Destaques

• Filtro opcional no webhook global — reduz ruído e carga no endpoint central quando você só precisa de um subconjunto de eventos (ex.: mensagens e sessão).
• README expandido — todos os tipos de evento suportados documentados com o que dispara, agrupados por categoria, mais tabela instância × global (escopo, filtro, HMAC, retry).

---

Added ✅

• Webhook global — filtro de eventos

  • Variável de ambiente KIRAGO_GLOBAL_WEBHOOK_EVENTS: lista separada por vírgula, mesmos nomes de evento do webhook por instância (Message, GroupMessage, Connected, …).
  • Flag de linha de comando -globalwebhookevents com o mesmo formato (alternativa ao .env).
  • Comportamento: string vazia ou ausente = sem filtro (encaminha todos os eventos, como antes).
  • Precedência: se a flag não estiver vazia, ela vale; caso contrário usa-se KIRAGO_GLOBAL_WEBHOOK_EVENTS do ambiente.
  • Nomes de evento desconhecidos na lista são ignorados (apenas tipos válidos entram no filtro); conferir logs na subida para ver o filtro efetivo.

• README

  • Seção Eventos de webhook com tabelas por categoria (mensagens, grupos, sessão, QR, presença, sync, chamadas, newsletter, etc.).
  • Tabela comparativa Webhook da instância × Webhook global (configuração, filtro, payload com userID/instanceName, HMAC, retry).
  • Referência à variável KIRAGO_GLOBAL_WEBHOOK_EVENTS na tabela de variáveis de ambiente.

• kirago/.env.sample

  • Chaves KIRAGO_GLOBAL_WEBHOOK e KIRAGO_GLOBAL_WEBHOOK_EVENTS documentadas no exemplo.

Exemplo rápido (.env)

KIRAGO_GLOBAL_WEBHOOK=https://seu-servidor.com/hook
KIRAGO_GLOBAL_WEBHOOK_EVENTS=Message,GroupMessage,Connected

Equivalente via CLI (quando preferir não usar .env para isso):

-globalwebhookevents=Message,GroupMessage,Connected

---

Changed ♻️

• ♻️ Documentação: README passa a ser a referência principal para nomes e significados dos eventos em PT‑BR (alinhado ao painel e ao POST /webhook).

Notas para quem faz deploy

• O webhook global continua exigindo KIRAGO_GLOBAL_WEBHOOK (URL); o filtro só restringe quais eventos são enviados.
• HMAC global (KIRAGO_GLOBAL_HMAC_KEY) e diferenças de retry em relação ao webhook por instância permanecem como descrito no README.

Atualização KiraGo (CRM + Typebot + Mídias + Dashboard) 🚀 Versão 1.4

Atualização KiraGo 🚀 Versão 1.4

Release focada em integrações, automação de conversa e melhorias de usabilidade no painel/dashboard.

✨ O que há de novo

✅ Integração com CRM KiraGo

• Configuração por instância (URL + token)
• Envio inbound padronizado para texto, mídias e reação
• Suporte para sincronização de histórico em lotes (HistoryBatch)

✅ Integração com Typebot (automático)

• Fluxo 1:1 automático (recebe mensagem, envia ao Typebot e responde no WhatsApp)
• Gatilhos por palavra-chave/operador
• Palavras de parada e controle de sessão

✅ Mídias e interativos

• Endpoint dedicado para GIF (/chat/send/gif)
• Suporte a GIF em headers interativos (botões/carrossel) com conversão para MP4 quando necessário
• Melhorias de compatibilidade para imagem/vídeo/áudio/documento

✅ Enquetes

• Envio de poll via helper oficial
• Melhor tratamento de votos no webhook

✅ Dashboard

• Melhorias visuais e responsividade
• Ajustes de UX em conexão/pairphone
• Melhor organização de cards e integrações

✅ Estabilidade geral

• Melhorias de webhook/eventos
• Ajustes em sessão, conexão e tratamento de erros
• Atualizações no Swagger/documentação PT-BR

🐳 Imagens Docker

• ggdadds/kirago:1.4
• ggdadds/kirago:latest

Atualização KiraGo (Chatwoot + Typebot + Logs + Webhook) 🚀 Versão 1.3

Atualização KiraGo (Chatwoot + Typebot + Logs + Webhook) 🚀 Versão 1.3

Release focada em automação de conversa, integração com Chatwoot, Typebot, painel com logs e webhook mais confiável.

✨ O que há de novo

✅ Integração com Chatwoot

• Envio e recebimento de mensagens
• Reações
• Reply com melhor mapeamento de mensagens
• Melhor suporte a histórico e sincronização

✅ Integração com Typebot

• Fluxo automático entre WhatsApp e Typebot
• Configuração pelo painel
• Suporte a public_id, base_url, token e modo preview
• Gatilhos por palavra-chave e modos avançados
• Controle de expiração de sessão
• Mensagem de fallback quando não houver correspondência
• Opções para reiniciar fluxo, manter sessão e responder no próprio número
• Suporte a mídia retornada pelo Typebot

✅ Painel com visualizador de logs

• Novo visualizador de logs do webhook no dashboard
• Consulta mais fácil de eventos, erros e entregas
• Melhor rastreabilidade para diagnóstico

✅ Webhook mais confiável

• Fila interna para entrega de eventos
• Retry com backoff exponencial
• Menos perda de eventos em falhas temporárias
• Melhor controle de envio em segundo plano

✅ Docker

• Build corrigido e estabilizado
• Melhor compatibilidade na geração da imagem

✅ Whatsmeow atualizado

• Motor WhatsApp atualizado para acompanhar mudanças e melhorias recentes
• Mais estabilidade na camada de conexão e eventos

🔧 Melhorias gerais

• Ajustes de compatibilidade com banco e inicialização
• Melhor organização dos fluxos internos de eventos
• Correções de integração entre painel, webhook, Chatwoot e Typebot

⚙️ Variáveis de ambiente opcionais
WEBHOOK_RETRY_ENABLED=true|false
WEBHOOK_RETRY_COUNT=5
WEBHOOK_RETRY_DELAY_SECONDS=30
WEBHOOK_ERROR_QUEUE_NAME=webhook_errors

📝 Observação
Esta versão consolida as melhorias principais da linha 1.3 e já pode ser publicada como release estável.

Atualização KiraGo (Painel + Webhook + Swagger) 🚀 Versão 1.2

Atualização focada em deixar o painel mais moderno, o webhook mais controlável e a documentação da API mais amigável (PT‑BR) ✅

✨ Destaques

• 🔔 Webhook: botão Ativo/Pausado (para de enviar sem apagar URL/eventos)
• 👥 Webhook: eventos de grupos separados (ex.: GroupMessage, GroupReadReceipt) mantendo a mesma URL
• 🧩 Painel: página da instância mais moderna e responsiva (cards + ações rápidas + layout melhor)
• 📚 API (/api): Swagger mais fácil pra leigo, PT‑BR e tema escuro consistente (inclui modal “Autorizar”)
• 🧪 develop.html: protótipo do Gerenciador de Intenções (para desenvolvimento)

✅ Correções

• 🛠️ Banco: compatibilidade ao iniciar com banco antigo (cria a coluna webhook_active quando faltar)
• 🌙 Swagger: ajustes de contraste no modo escuro (“No parameters”, cabeçalhos e modal de autorização)

🔄 Como atualizar

Use uma das imagens:

• ggdadds/kirago:latest
• ggdadds/kirago:1.2

Atualização KiraGo (Painel/WhatsApp) 🚀 Versão 1.1

Pessoal, liberamos uma atualização com melhorias no painel e correções importantes ✅

• Webhook 🔔: modal reorganizado (URL em primeiro) e eventos por categorias em checkboxes (bem melhor no tema escuro 🌙).
• Criar instância 🧩: seleção de eventos do webhook também virou checkboxes.
• Conexão 🔗: botão “Desconectar” agora funciona mesmo quando está só no QR Code 📲 (antes de logar).
• S3/Mídia 🗂️: corrigido um bug de cache que às vezes ignorava o media_delivery (agora respeita base64/s3/both certinho).
• Licença/Atualizações 🔒: validação da janela de updates usando a data do build (bloqueia/permite versões conforme o plano).

Para Atualizar só usa versão ggdadds/kirago:latest ou ggdadds/kirago:1.1

Se alguém notar algo estranho após atualizar, faz um hard refresh (Ctrl+Shift+R) 🔄 e me chama com print/log 🧾.