Integre com ajuda da sua IA
Um kit para implementar a HookCloud Partner no seu CRM, chatbot, plataforma de campanhas ou automações. Use o prompt com Claude, Codex, Gemini, Grok ou outra ferramenta capaz de trabalhar no seu projeto.
Material 2026-10-20 92 operações e receitas
Comece pelo projeto do seu sistema
- Baixe o kit e extraia o ZIP. Se a IA aceitar anexos, envie o guia e a referência. Se aceitar apenas texto, copie o prompt e indique os links públicos.
- Informe o objetivo e a tecnologia usada. Explique quais recursos já existem, como seus clientes são identificados e qual banco e backend utiliza.
- Peça a análise do código antes da implementação. O prompt orienta a IA a conferir os contratos, preservar seu sistema e planejar por etapas.
- Configure os segredos no servidor e teste. Revise o código gerado e resolva os requisitos de autenticação dos eventos antes de atender clientes reais.
Você também encontra o kit no Portal → Integração → Kit de integração com IA. Lá, selecione o tipo do seu sistema antes de copiar o prompt.
Arquivos prontos para a IA
| Arquivo | Para que serve |
|---|---|
| PROMPT.md | Instrução inicial: analisar seu projeto, consultar os contratos e implementar com testes. |
| GUIA-IMPLEMENTACAO.md | Arquitetura, fluxos, eventos, identidade, janelas, erros, segurança e critérios de aceite. |
| REFERENCIA-API.md | Todas as 92 operações e receitas, com campos, autenticação, respostas, erros e referências. |
| API-CONTRACT.json | O mesmo catálogo em formato estruturado. É um catálogo próprio, não um arquivo OpenAPI. |
| WEBHOOK-EVENTS.json | Envelopes e campos dos eventos HookCloud, com significado, ações e reconciliação, inclusive preferências de marketing. |
| META-WEBHOOK-FIELDS.json | Campos Meta, payloads, referências e tratamento atual no Partner; assinatura de um campo não garante que todo evento chegue ao seu endpoint. |
hookcloud-partner/SKILL.md | Skill com referências para ferramentas que aceitam esse formato. Use a pasta completa contida no ZIP. |
| manifest.json | Versão, quantidade de operações e hashes dos arquivos para conferir integridade e atualização. |
Não precisa instalar uma skill para começar. O prompt e os guias funcionam como material de contexto. A compatibilidade de instalação da skill depende da ferramenta escolhida.
O que cada parte oferece
| Parte | Responsabilidade |
|---|---|
| HookCloud Partner API | Clientes, instâncias, sessões Connect, credenciais autorizadas no backend, estado da conexão, risco, templates em cache, endpoints e desconexão. |
| Meta Graph API | Envio de texto, mídia e templates; criação, edição e exclusão de templates conforme as permissões e regras da Meta. |
| Seu sistema | Histórico de conversas, usuários e permissões, atendimento humano, chatbot, campanhas, fila de envio, consentimento, armazenamento e processamento dos webhooks. |
Os itens meta-send-text e similares do catálogo são receitas de chamadas à Graph. Não são endpoints de envio da HookCloud. A Partner API Key autentica a HookCloud; o Meta Access Token da instância autentica a Graph, sempre no servidor.
Leia os contratos completos e os campos de webhook Meta. O kit não copia a implantação interna de outra aplicação nem depende de seus clientes, bancos ou credenciais.
Adapte ao seu tipo de produto
CRM e atendimento
Vincule seus clientes por external_customer_id, importe conexões existentes sem criar vagas duplicadas, armazene conversas e controle o acesso dos atendentes.
Chatbot
Processe mensagens autenticadas, evite responder duas vezes, registre o histórico e permita passagem para um atendente. Revalide a conexão e a janela antes de enviar.
Campanhas
Use destinatários autorizados, templates aprovados quando exigidos, fila com reserva atômica, cancelamento e limites. Aceitação da API não significa entrega.
Automações
Reaja aos eventos para atualizar o seu sistema. Use cache e reconciliação controlada, sem consultar a Meta a cada atualização da tela.
A desconexão deve mostrar a solicitação em andamento e consultar o resultado confirmado. Não mostre “desconectado” apenas porque o usuário clicou; não confunda o encerramento da conexão com a remoção de uma parceria empresarial inteira.
Resolva a autenticação dos webhooks antes de operar
Nunca use a Partner API Key ou o verify token como substitutos de um segredo HMAC. Não solicite nem distribua o App Secret da HookCloud. Enquanto a verificação não estiver provisionada, mantenha efeitos e respostas automáticas dos POSTs desativados. Veja configuração inicial e eventos e assinaturas.
Guarde credenciais somente no backend. O kit e o prompt são públicos e não incluem sua API Key, tokens, identificadores ou dados dos seus clientes.
O que a implementação precisa provar
- Um cliente não acessa conexão, mensagem ou token de outro.
- Retries e cliques duplicados não criam instâncias ou envios duplicados; resultado ambíguo fica em reconciliação.
- Eventos repetidos e fora de ordem não regressam o estado; uma autorização antiga não atualiza uma nova geração.
- Texto livre depende de mensagem autenticada recebida nas últimas 24 horas. FEP é benefício de cobrança e não estende essa permissão.
- Telefone e BSUID são identidades diferentes; username reservado não é destinatário.
- O catálogo de templates trata aprovação, categoria, rejeição, qualidade e cache separadamente.
- A interface acompanha conexão, desconexão, alertas, datas e resultados sem apresentar pendência como sucesso.
- Testes de envio real, criação, exclusão ou desligamento exigem autorização explícita do responsável.
As regras da Meta podem mudar. Antes de implementar, confira a versão deste kit e as referências oficiais de cada receita. O roteiro deve produzir código adequado à sua aplicação; ele não garante que uma geração de IA esteja pronta para produção sem revisão.