Versão 1.0.0 — produção

Primeira release estável da HookCloud Partner API, com onboarding, webhooks por número, billing Stripe, catálogo de templates, saúde de entregas, alertas Meta, HookCloud Academy e hardening de produção.

  • Links de referência migrados para a documentação oficial Meta for Developers.
  • Políticas de segurança, idempotência, retries e rate limits consolidadas.
  • Rotas públicas diferenciadas de rotas internas do portal.
Referências

Changelog

Principais mudanças da documentação e da API pública.

Busca por cliente e primeira conexão registrada

  • O Portal permite buscar números dentro do card de cada cliente, por nome, telefone, Instance Key e IDs Meta. Termo, aba e paginação são independentes por cliente enquanto você navega no Portal. A busca usa os dados locais já carregados, sem novas consultas à Meta.
  • first_connected_at expõe a primeira evidência registrada para a identidade do número no parceiro, preservada em reconexões e movimentações no mesmo parceiro. Sem evidência, retorna null. Veja o contrato e os limites do histórico.
  • O monitoramento interno de consumo do Admin lê estatísticas já registradas pela HookCloud; abrir esse painel não dispara consultas à Meta. Esse recurso administrativo não integra a API pública de assinantes.

Lifecycle e notificações configuráveis

  • Inativação idempotente: callback já removido não gera falso erro.
  • Cliente inativo bloqueia connect e reconnect até reativação explícita.
  • Sino unificado para Academy, Alertas Meta, Templates, Saúde de Entregas e Billing.
  • Preferências por membro e lembretes aproximadamente 24 horas antes da cobrança.
  • Documentação ampliada com parâmetros, enums, defaults, exemplos e erros por endpoint.

Operações seguras de clientes

  • Listagem e consulta paginada de clientes.
  • Edição de nome, e-mail e telefone com IDs imutáveis.
  • Histórico, merge de duplicados e movimentação de instâncias.
  • Idempotência e eventos HookCloud para sincronização.

Templates e Saúde de Entregas

  • Catálogo de templates em cache
  • Refresh Graph controlado
  • Webhook template.updated
  • Relatórios 131049 e 131042
  • Saúde de entregas

Alertas Meta

  • Qualidade, conta, nome e templates
  • Mapeamento por WABA, cliente e instância
  • Política de risco por cliente final

Webhook self-service

  • Validação HTTPS
  • Migração automática dos números ativos
  • Retry por instância

Stripe Billing

  • Trial, planos e excedentes
  • Upgrade imediato e downgrade agendado
  • Suspensão rígida por inadimplência

Callback por número

  • Lifecycle seguro
  • Remoção remota antes de liberar slot
  • Token Meta criptografado
Esta página ajudou?Use o Partner Portal para suporte e compartilhe o link desta seção.