whatsapp-docs-mcp 1.0.0

package/dist/utils/fileLoader.js

@@ -0,0 +1,126 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadMarkdownFile = loadMarkdownFile;
+exports.findAllMarkdownFiles = findAllMarkdownFiles;
+exports.getDocsPath = getDocsPath;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+/**
+ * Carrega conteúdo de arquivo markdown
+ */
+function loadMarkdownFile(filePath) {
+    try {
+        return fs.readFileSync(filePath, 'utf-8');
+    }
+    catch (error) {
+        throw new Error(`Failed to load file ${filePath}: ${error}`);
+    }
+}
+/**
+ * Encontra todos os arquivos .md recursivamente em um diretório
+ */
+function findAllMarkdownFiles(dir, fileList = []) {
+    const files = fs.readdirSync(dir);
+    files.forEach((file) => {
+        const filePath = path.join(dir, file);
+        const stat = fs.statSync(filePath);
+        if (stat.isDirectory()) {
+            findAllMarkdownFiles(filePath, fileList);
+        }
+        else if (file.endsWith('.md')) {
+            fileList.push(filePath);
+        }
+    });
+    return fileList;
+}
+/**
+ * Obtém o caminho da pasta docs relativo ao pacote instalado
+ *
+ * Estratégia para encontrar docs/ quando instalado via npm:
+ * - Quando executado: node_modules/whatsapp-docs-mcp/dist/index.js
+ * - __dirname em dist/utils/fileLoader.js = node_modules/whatsapp-docs-mcp/dist/utils/
+ * - docs/ está em: node_modules/whatsapp-docs-mcp/docs/
+ * - Caminho relativo: ../../docs (subir de dist/utils/ para dist/, depois para raiz do pacote)
+ */
+function getDocsPath() {
+    const fs = require('fs');
+    // Caminho atual: dist/utils/ quando compilado e executado
+    const currentDir = __dirname;
+    // Caminho mais provável: ../../docs relativo a dist/utils/
+    // Isso resolve para: node_modules/whatsapp-docs-mcp/docs/ quando instalado
+    const docsPath = path.resolve(currentDir, '../../docs');
+    // Verifica se existe
+    if (fs.existsSync(docsPath)) {
+        // Valida que é realmente a pasta docs (tem pelo menos um .md ou subdiretório)
+        try {
+            const entries = fs.readdirSync(docsPath);
+            const isValid = entries.some((entry) => {
+                const entryPath = path.join(docsPath, entry);
+                const stat = fs.statSync(entryPath);
+                return entry.endsWith('.md') || stat.isDirectory();
+            });
+            if (isValid) {
+                return docsPath;
+            }
+        }
+        catch (error) {
+            // Se houver erro ao ler, continua para tentar outros caminhos
+        }
+    }
+    // Fallback: tenta caminhos alternativos
+    const fallbackPaths = [
+        path.resolve(currentDir, '../../../docs'), // Para casos especiais de estrutura
+        path.resolve(process.cwd(), 'docs'), // Relativo ao diretório de trabalho atual
+    ];
+    for (const fallbackPath of fallbackPaths) {
+        if (fs.existsSync(fallbackPath)) {
+            try {
+                const entries = fs.readdirSync(fallbackPath);
+                const hasMarkdown = entries.some((entry) => entry.endsWith('.md') || fs.statSync(path.join(fallbackPath, entry)).isDirectory());
+                if (hasMarkdown) {
+                    return fallbackPath;
+                }
+            }
+            catch {
+                continue;
+            }
+        }
+    }
+    // Se não encontrou em nenhum lugar, retorna o caminho esperado
+    // O erro será lançado quando tentar ler os arquivos
+    return docsPath;
+}
+//# sourceMappingURL=fileLoader.js.map

package/dist/utils/fileLoader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileLoader.js","sourceRoot":"","sources":["../../src/utils/fileLoader.ts"],"names":[],"mappings":"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"}

package/dist/utils/search.d.ts

@@ -0,0 +1,27 @@
+export interface SearchResult {
+    path: string;
+    title: string;
+    excerpt: string;
+    relevance: number;
+}
+/**
+ * Busca textual simples em conteúdo markdown
+ */
+export declare function searchInContent(content: string, query: string): boolean;
+/**
+ * Extrai título do arquivo markdown (primeiro # ou nome do arquivo)
+ */
+export declare function extractTitle(content: string, filePath: string): string;
+/**
+ * Extrai descrição (primeiro parágrafo ou primeiras linhas)
+ */
+export declare function extractDescription(content: string, maxLength?: number): string;
+/**
+ * Extrai trecho relevante ao redor da busca
+ */
+export declare function extractExcerpt(content: string, query: string, contextLines?: number): string;
+/**
+ * Calcula relevância simples baseada em ocorrências
+ */
+export declare function calculateRelevance(content: string, query: string): number;
+//# sourceMappingURL=search.d.ts.map

package/dist/utils/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/utils/search.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAKvE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAgBtE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,GAAE,MAAY,GAAG,MAAM,CAmBnF;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,YAAY,GAAE,MAAU,GAAG,MAAM,CAoB/F;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAczE"}

package/dist/utils/search.js

@@ -0,0 +1,91 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.searchInContent = searchInContent;
+exports.extractTitle = extractTitle;
+exports.extractDescription = extractDescription;
+exports.extractExcerpt = extractExcerpt;
+exports.calculateRelevance = calculateRelevance;
+/**
+ * Busca textual simples em conteúdo markdown
+ */
+function searchInContent(content, query) {
+    const normalizedQuery = query.toLowerCase().trim();
+    const normalizedContent = content.toLowerCase();
+    return normalizedContent.includes(normalizedQuery);
+}
+/**
+ * Extrai título do arquivo markdown (primeiro # ou nome do arquivo)
+ */
+function extractTitle(content, filePath) {
+    // Tenta encontrar primeiro título H1
+    const h1Match = content.match(/^#\s+(.+)$/m);
+    if (h1Match) {
+        return h1Match[1].trim();
+    }
+    // Tenta encontrar primeiro título H2
+    const h2Match = content.match(/^##\s+(.+)$/m);
+    if (h2Match) {
+        return h2Match[1].trim();
+    }
+    // Usa nome do arquivo como fallback
+    const fileName = filePath.split('/').pop() || filePath;
+    return fileName.replace('.md', '').replace(/_/g, ' ').replace(/-/g, ' ');
+}
+/**
+ * Extrai descrição (primeiro parágrafo ou primeiras linhas)
+ */
+function extractDescription(content, maxLength = 200) {
+    // Remove código e links
+    const cleanContent = content
+        .replace(/```[\s\S]*?```/g, '')
+        .replace(/\[([^\]]+)\]\([^\)]+\)/g, '$1')
+        .replace(/#{1,6}\s+/g, '')
+        .trim();
+    // Pega primeiro parágrafo significativo
+    const lines = cleanContent.split('\n').filter(line => line.trim().length > 20);
+    if (lines.length > 0) {
+        const firstParagraph = lines[0];
+        if (firstParagraph.length > maxLength) {
+            return firstParagraph.substring(0, maxLength) + '...';
+        }
+        return firstParagraph;
+    }
+    return cleanContent.substring(0, maxLength) + (cleanContent.length > maxLength ? '...' : '');
+}
+/**
+ * Extrai trecho relevante ao redor da busca
+ */
+function extractExcerpt(content, query, contextLines = 3) {
+    const normalizedQuery = query.toLowerCase();
+    const lines = content.split('\n');
+    for (let i = 0; i < lines.length; i++) {
+        if (lines[i].toLowerCase().includes(normalizedQuery)) {
+            const start = Math.max(0, i - contextLines);
+            const end = Math.min(lines.length, i + contextLines + 1);
+            const excerpt = lines.slice(start, end).join('\n');
+            // Limita tamanho
+            if (excerpt.length > 300) {
+                return excerpt.substring(0, 300) + '...';
+            }
+            return excerpt;
+        }
+    }
+    // Fallback: primeiras linhas
+    return lines.slice(0, 5).join('\n').substring(0, 300);
+}
+/**
+ * Calcula relevância simples baseada em ocorrências
+ */
+function calculateRelevance(content, query) {
+    const normalizedQuery = query.toLowerCase();
+    const normalizedContent = content.toLowerCase();
+    const words = normalizedQuery.split(/\s+/).filter(w => w.length > 2);
+    let score = 0;
+    words.forEach(word => {
+        const occurrences = (normalizedContent.match(new RegExp(word, 'g')) || []).length;
+        score += occurrences;
+    });
+    // Normaliza para 0-1
+    return Math.min(1, score / 10);
+}
+//# sourceMappingURL=search.js.map

package/dist/utils/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../src/utils/search.ts"],"names":[],"mappings":"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"}

package/docs/QUICK_REFERENCE.md

@@ -0,0 +1,223 @@
+# Referência Rápida - WhatsApp Business API
+
+Este documento fornece uma referência rápida dos endpoints e recursos mais comuns da API.
+
+## 🔑 Autenticação
+
+```bash
+Authorization: Bearer <ACCESS_TOKEN>
+```
+
+**Obter Token**: [Tokens de Acesso](./recado/sobre_a_plataforma/access_tokens.md)
+
+## 📤 Enviar Mensagens
+
+### Base URL
+```
+https://graph.facebook.com/v23.0/{PHONE_NUMBER_ID}/messages
+```
+
+### Mensagem de Texto
+```json
+{
+  "messaging_product": "whatsapp",
+  "recipient_type": "individual",
+  "to": "5511999999999",
+  "type": "text",
+  "text": {
+    "body": "Olá! Esta é uma mensagem de teste."
+  }
+}
+```
+**Documentação**: [Mensagens de Texto](./mensagens/tipos_de_mensagens/text_messages.md)
+
+### Mensagem com Imagem
+```json
+{
+  "messaging_product": "whatsapp",
+  "recipient_type": "individual",
+  "to": "5511999999999",
+  "type": "image",
+  "image": {
+    "link": "https://example.com/image.jpg"
+  }
+}
+```
+**Documentação**: [Mensagens de Imagem](./mensagens/tipos_de_mensagens/image_messages.md)
+
+### Mensagem com Template
+```json
+{
+  "messaging_product": "whatsapp",
+  "recipient_type": "individual",
+  "to": "5511999999999",
+  "type": "template",
+  "template": {
+    "name": "hello_world",
+    "language": {
+      "code": "pt_BR"
+    }
+  }
+}
+```
+**Documentação**: [Mensagens com Template](./mensagens/tipos_de_mensagens/template_messages.md)
+
+## 📥 Webhooks
+
+### Configurar Webhook
+```
+POST /v23.0/{APP_ID}/subscriptions
+```
+
+**Campos necessários**:
+- `object`: "whatsapp_business_account"
+- `callback_url`: "https://seu-dominio.com/webhook"
+- `fields`: ["messages", "message_status"]
+
+**Documentação**: [Webhooks > Visão Geral](./webhooks/visao_geral/overview.md)
+
+### Estrutura de Payload Recebido
+```json
+{
+  "object": "whatsapp_business_account",
+  "entry": [{
+    "id": "WHATSAPP_BUSINESS_ACCOUNT_ID",
+    "changes": [{
+      "value": {
+        "messaging_product": "whatsapp",
+        "metadata": {
+          "display_phone_number": "15551234567",
+          "phone_number_id": "PHONE_NUMBER_ID"
+        },
+        "messages": [{
+          "from": "5511999999999",
+          "id": "wamid.xxx",
+          "timestamp": "1234567890",
+          "text": {
+            "body": "Mensagem recebida"
+          },
+          "type": "text"
+        }]
+      },
+      "field": "messages"
+    }]
+  }]
+}
+```
+**Documentação**: [Webhooks > Referência > Mensagens](./webhooks/referencia/messages/)
+
+## 📋 Endpoints Principais
+
+### Gerenciamento de Conta
+- **Listar Contas**: `GET /v23.0/{BUSINESS_ID}/owned_whatsapp_business_accounts`
+- **Obter Conta**: `GET /v23.0/{WHATSAPP_BUSINESS_ACCOUNT_ID}`
+- **Documentação**: [Referência > Conta do WhatsApp Business](./referencia/conta_do_whatsapp_business/)
+
+### Gerenciamento de Números
+- **Listar Números**: `GET /v23.0/{WHATSAPP_BUSINESS_ACCOUNT_ID}/phone_numbers`
+- **Obter Número**: `GET /v23.0/{PHONE_NUMBER_ID}`
+- **Registrar Número**: `POST /v23.0/{PHONE_NUMBER_ID}/register`
+- **Documentação**: [Referência > Telefone do WhatsApp Business](./referencia/telefone_do_whatsapp_business/)
+
+### Mídia
+- **Upload**: `POST /v23.0/{PHONE_NUMBER_ID}/media`
+- **Download**: `GET /v23.0/{MEDIA_ID}`
+- **Documentação**: [Referência > Mídias](./referencia/midias/)
+
+### Templates
+- **Listar Templates**: `GET /v23.0/{WHATSAPP_BUSINESS_ACCOUNT_ID}/message_templates`
+- **Criar Template**: `POST /v23.0/{WHATSAPP_BUSINESS_ACCOUNT_ID}/message_templates`
+- **Documentação**: [Modelos > Gerenciamento](./modelos/gerenciamento_de_modelos/)
+
+## 🔍 Códigos de Status Comuns
+
+### Status de Mensagem
+- `sent` - Mensagem enviada
+- `delivered` - Mensagem entregue
+- `read` - Mensagem lida
+- `failed` - Falha no envio
+
+**Documentação**: [Webhooks > Referência > Mensagens > Status](./webhooks/referencia/messages/status.md)
+
+### Códigos de Erro Comuns
+- `100` - Parâmetro inválido
+- `131031` - Número de telefone inválido
+- `131026` - Template não encontrado
+- `131047` - Rate limit excedido
+
+**Documentação Completa**: [Suporte > Códigos de Erro](./suporte/error_codes.md)
+
+## ⚡ Limites Importantes
+
+### Janela de Atendimento
+- **24 horas**: Após receber mensagem do usuário
+- **Template obrigatório**: Para mensagens após 24h
+
+**Documentação**: [Mensagens > Limites](./mensagens/limites_de_mensagens/)
+
+### Rate Limits
+- Variam por tipo de mensagem e qualidade da conta
+- Ver documentação completa para detalhes
+
+**Documentação**: [Mensagens > Limites de Mensagens](./mensagens/limites_de_mensagens/messaging_limits.md)
+
+## 🛠️ Casos de Uso Comuns
+
+### 1. Enviar Mensagem de Boas-Vindas
+```bash
+curl -X POST "https://graph.facebook.com/v23.0/{PHONE_NUMBER_ID}/messages" \
+  -H "Authorization: Bearer {ACCESS_TOKEN}" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "messaging_product": "whatsapp",
+    "to": "5511999999999",
+    "type": "template",
+    "template": {
+      "name": "welcome_template",
+      "language": {"code": "pt_BR"}
+    }
+  }'
+```
+
+### 2. Processar Mensagem Recebida (Webhook)
+```javascript
+// Exemplo Node.js
+app.post('/webhook', (req, res) => {
+  const entry = req.body.entry[0];
+  const changes = entry.changes[0];
+  
+  if (changes.field === 'messages') {
+    const message = changes.value.messages[0];
+    const from = message.from;
+    const text = message.text.body;
+    
+    // Processar mensagem...
+  }
+  
+  res.sendStatus(200);
+});
+```
+
+### 3. Verificar Status de Entrega
+```bash
+curl -X GET "https://graph.facebook.com/v23.0/{MESSAGE_ID}" \
+  -H "Authorization: Bearer {ACCESS_TOKEN}"
+```
+
+## 📚 Links Rápidos
+
+- **Início Rápido**: [Começar](./comecar/get_started.md)
+- **Tipos de Mensagens**: [Mensagens > Tipos](./mensagens/tipos_de_mensagens/)
+- **Webhooks**: [Webhooks > Visão Geral](./webhooks/visao_geral/)
+- **Referência Completa**: [Referência](./referencia/)
+- **Suporte**: [Suporte](./suporte/)
+
+## 🔗 Recursos Externos
+
+- **Postman Collection**: [Coleção Oficial](https://www.postman.com/meta/whatsapp)
+- **GitHub Examples**: [Exemplos de Código](https://github.com/fbsamples/whatsapp-business-jaspers-market)
+- **Status da API**: [Status Page](https://developers.facebook.com/status/)
+
+---
+
+**Nota**: Esta é uma referência rápida. Para documentação completa, consulte os documentos específicos em cada seção.

package/docs/anuncios_com_clique_para_whatsapp/AGENTS.md

@@ -0,0 +1,8 @@
+# Anúncios com Clique para WhatsApp
+
+Anúncios com clique para WhatsApp
+
+## Documentos Disponíveis
+
+- [Welcome Message Sequences](./welcome_message_sequences.md)
+