Skip to content

Atualização KiraGo Versão 1.5

Choose a tag to compare

View all tags
@luiis716 luiis716 released this 25 Apr 14:03
1.5
f9f31e3
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

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.
Assets 2
Loading