# nodes

node_type: n8n-nodes-docx-to-md.docxtomd
package_name: n8n-nodes-docx-to-md
display_name: docxtomd
description: n8n node to convert Docx files to Markdown
category: Community
development_style: declarative
version: 0.2.1
properties_schema: []
operations: []
credentials_required: []
updated_at: 2026-04-16 09:43:37
author_name: sfrangulov
author_github_url: git+https://github.com/sfrangulov/n8n-nodes-docx-to-md.git
npm_package_name: n8n-nodes-docx-to-md
npm_version: 0.2.1
community_fetched_at: 2026-04-16T09:43:37.355Z
ai_summary_generated_at: 2026-03-25 22:47:20
npm_readme:
  # n8n-nodes-docx-to-md

  This is an n8n community node. It lets you convert Microsoft Word documents (.docx) to Markdown format in your n8n workflows.

  This node provides seamless conversion of Word documents to clean, GitHub-flavored Markdown with automatic formatting correction and linting.

  [n8n](https://n8n.io/) is a [fair-code licensed](https://docs.n8n.io/reference/license/) workflow automation platform.

  [Installation](#installation)  
  [Operations](#operations)  
  [Compatibility](#compatibility)  
  [Usage](#usage)  
  [Resources](#resources)

  ## Installation

  Follow the [installation guide](https://docs.n8n.io/integrations/community-nodes/installation/) in the n8n community nodes documentation.

  ## Operations

  The Docx to Markdown node supports the following operation:

  - **Convert**: Converts a Microsoft Word document (.docx) from binary data to clean Markdown format

  ### Features

  - Converts Word documents to GitHub-flavored Markdown
  - Automatically converts tables with proper headers
  - Applies markdown linting and formatting corrections
  - Preserves document structure and formatting
  - Supports headings, lists, tables, and basic text formatting
  - **Option to remove images** from the converted Markdown output

  ## Compatibility

  - Minimum n8n version: 1.0.0
  - Tested with n8n versions: 1.0.0+
  - Compatible with all n8n deployment methods (self-hosted, cloud, desktop)

  ## Usage

  ### Basic Setup

  1. Add the "Docx to Markdown" node to your workflow
  2. Configure the **Input Binary Field** parameter with the name of the field containing your Word document binary data (default: "data")
  3. Configure the **Destination Output Field** parameter with the name where you want the converted Markdown text to be stored (default: "text")
  4. Optionally, enable **Remove Images** if you want to exclude all images from the converted Markdown (default: false)

  ### Configuration Options

  | Parameter | Type | Default | Description |
  |-----------|------|---------|-------------|
  | Input Binary Field | String | "data" | Name of the field containing the Word document binary data |
  | Destination Output Field | String | "text" | Name of the field where converted Markdown will be stored |
  | Remove Images | Boolean | false | Whether to remove all images from the converted Markdown |

  ### Example Workflow

  1. Use an HTTP Request node or file input to get a .docx file
  2. Connect it to the Docx to Markdown node
  3. The converted Markdown will be available in the specified output field
  4. Use the Markdown output in subsequent nodes (e.g., save to file, send via email, etc.)

  ### Tips

  - The node automatically handles table formatting by converting the first row to headers
  - All markdown output is linted and formatted for consistency
  - Binary data should be in proper .docx format for best results
  - Use the "Remove Images" option when you need clean text-only output without image references
  - Images in Word documents are typically converted to markdown image syntax (`![alt](src)`) unless the Remove Images option is enabled

  ## Resources

  - [n8n community nodes documentation](https://docs.n8n.io/integrations/#community-nodes)
  - [Mammoth.js documentation](https://github.com/mwilliamson/mammoth.js/) (underlying conversion library)
  - [Turndown documentation](https://github.com/mixmark-io/turndown) (HTML to Markdown converter)
  - [GitHub Flavored Markdown Spec](https://github.github.com/gfm/)

  ## License

  [MIT](https://github.com/n8n-io/n8n-nodes-starter/blob/master/LICENSE.md)

ai_documentation_summary:
  {"purpose":"Converts Microsoft Word (.docx) files to GitHub-flavored Markdown with automatic formatting correction and linting.","capabilities":["Converts .docx files to Markdown","Automatically converts tables with proper headers","Applies markdown linting and formatting corrections","Preserves document structure and formatting","Supports headings, lists, tables, and basic text formatting","Option to remove images from output"],"authentication":"None","commonUseCases":["Converting uploaded Word documents to Markdown for documentation","Preparing Word content for GitHub repositories","Extracting text-only content from Word files by removing images","Formatting Word documents for web publishing"],"limitations":["Requires binary .docx file input","Images are converted to markdown syntax unless explicitly removed","Depends on Mammoth.js and Turndown libraries for conversion"],"relatedNodes":["HTTP Request","File Input","Save to File","Send Email","GitHub Webhook"]}


node_type: n8n-nodes-puppeteer.puppeteer
package_name: n8n-nodes-puppeteer
display_name: puppeteer
description: n8n node for browser automation using Puppeteer
category: Community
development_style: declarative
version: 1.5.0
properties_schema: []
operations: []
credentials_required: []
updated_at: 2026-04-16 09:43:37
author_name: drudge
author_github_url: git+https://github.com/drudge/n8n-nodes-puppeteer.git
npm_package_name: n8n-nodes-puppeteer
npm_version: 1.5.0
community_fetched_at: 2026-04-16T09:43:37.356Z
ai_summary_generated_at: 2026-03-25 22:47:20
npm_readme:
  # n8n-nodes-puppeteer

  ![n8n.io - Workflow Automation](https://raw.githubusercontent.com/n8n-io/n8n/master/assets/n8n-logo.png)

  [n8n](https://www.n8n.io) node for browser automation using [Puppeteer](https://pptr.dev/). Execute custom scripts, capture screenshots and PDFs, scrape content, and automate web interactions using Chrome/Chromium's DevTools Protocol. Full access to Puppeteer's API plus n8n's Code node capabilities makes this node powerful for any browser automation task.

  ## How to install

  ### Community Nodes (Recommended)

  For n8n version 0.187 and later, you can install this node through the Community Nodes panel:

  1. Go to **Settings > Community Nodes**
  2. Select **Install**
  3. Enter `n8n-nodes-puppeteer` in **Enter npm package name**
  4. Agree to the [risks](https://docs.n8n.io/integrations/community-nodes/risks/) of using community nodes
  5. Select **Install**

  ### Docker Installation (Recommended for Production)

  We provide a ready-to-use Docker setup in the `docker/` directory that includes all necessary dependencies and configurations:

  1. Clone this repository

  2. Build your Docker image:
  ```bash
  npm run docker:build
  ```

  3. Run the container:
  ```bash
  npm run docker:run
  ```

  Or for testing without persistent data:
  ```bash
  npm run docker:run:fresh
  ```

  #### Available Docker Scripts

  - `npm run docker:build` - Build the Docker image with Puppeteer node
  - `npm run docker:run` - Run n8n with persistent data volume
  - `npm run docker:run:fresh` - Run n8n without persistent data (clean start)
  - `npm run docker:run:external-browser` - Run with external browser connection example
  - `npm run docker:test` - Quick test to verify the image works
  - `npm run docker:shell` - Open a shell inside the container for debugging
  - `npm run docker:clean` - Remove the data volume
  - `npm run docker:clean:all` - Remove data volume and images

  #### Container Optimizations

  When running in Docker or Kubernetes, the node automatically detects the container environment and applies necessary Chrome launch arguments (`--no-sandbox`, `--disable-setuid-sandbox`, `--disable-dev-shm-usage`, `--disable-gpu`). This happens automatically - no configuration needed!

  A blue info banner will appear in the node when a container is detected. This can be toggled off in Options > Add Container Arguments if needed.

  ### Manual Installation

  For a standard installation without Docker:

  ```bash
  # Navigate to your n8n root directory
  cd /path/to/n8n

  # Install the package
  npm install n8n-nodes-puppeteer
  ```

  Note: By default, when Puppeteer is installed, it downloads a compatible version of Chromium. While this works, it increases installation size and may not include necessary system dependencies. For production use, we recommend either using the Docker setup above or installing system Chrome/Chromium and setting the `PUPPETEER_SKIP_CHROMIUM_DOWNLOAD=true` environment variable.

  ## Browser Setup Options

  ### 1. Local Browser (Docker Setup - Recommended)

  The included Docker setup provides the most reliable way to run Chrome/Chromium with all necessary dependencies. It uses Alpine Linux's Chromium package and includes all required fonts and libraries.

  ### 2. Remote Browser (Alternative for Cloud)

  You can also connect to an external Chrome or Firefox instance using the "Browser WebSocket Endpoint" option. This approach:
  - Eliminates the need for Chrome dependencies in your n8n environment
  - Simplifies deployment and maintenance
  - Provides better resource isolation
  - Works great for cloud and containerized deployments
  - Supports Firefox via WebDriver BiDi protocol

  Options include:
  - **Managed Services**: Use [browserless](https://browserless.io) or [browsercloud](https://browsercloud.io)
  - **Self-Hosted Chrome**: Run your own [browser container](https://docs.browserless.io/docker/config):
    ```bash
    docker run -p 3000:3000 -e "TOKEN=6R0W53R135510" ghcr.io/browserless/chromium
    ```
  - **Self-Hosted Firefox**: Run Firefox with WebDriver BiDi support

  #### Configuring Remote Browser Connection

  **Per-Node Configuration:**
  In any Puppeteer node, go to Options > Add Option:
  - Add "Browser WebSocket Endpoint" and enter your WebSocket URL (e.g., `ws://browserless:3000?token=6R0W53R135510`)
  - Add "Protocol" and select:
    - **CDP (Chrome DevTools Protocol)** - for Chrome/Chromium (default)
    - **WebDriver BiDi** - for Firefox

  **Global Configuration via Environment Variables (Recommended):**

  Instead of configuring each node individually, you can set environment variables:

  ```bash
  # For Chrome/Chromium
  docker run -it -p 5678:5678 \
    -e PUPPETEER_BROWSER_WS_ENDPOINT=ws://browserless:3000 \
    -e PUPPETEER_PROTOCOL=cdp \
    n8n-puppeteer

  # For Firefox
  docker run -it -p 5678:5678 \
    -e PUPPETEER_BROWSER_WS_ENDPOINT=ws://firefox:4444 \
    -e PUPPETEER_PROTOCOL=webDriverBiDi \
    n8n-puppeteer
  ```

  Or with Docker Compose:

  ```yaml
  version: '3.8'
  services:
    n8n:
      image: n8n-puppeteer
      environment:
        - PUPPETEER_BROWSER_WS_ENDPOINT=ws://browserless:3000
        - PUPPETEER_PROTOCOL=cdp
      ports:
        - "5678:5678"
    
    browserless:
      image: browserless/chrome
      ports:
        - "3000:3000"
  ```

  When environment variables are set, a blue info banner will appear showing the configured endpoint. Individual nodes can still override these settings if needed.

  ## Troubleshooting

  If you see errors about missing shared libraries (like `libgobject-2.0.so.0` or `libnss3.so`), either:

  1. Install the missing Chrome dependencies
  2. Switch to using a remote browser with the WebSocket endpoint option

  For additional help, see [Puppeteer's troubleshooting guide](https://pptr.dev/troubleshooting).

  ## Node Reference

  - **Operations**

    - Get the full HTML contents of the page
    - Capture the contents of a page as a PDF document
    - Capture screenshot of all or part of the page
    - Execute custom script to interact with the page

  - **Options**

    - All Operations

      - **Batch Size**: Maximum number of pages to open simultaneously. More pages will consume more memory and CPU.
      - **Browser WebSocket Endpoint**: The WebSocket URL of the browser to connect to. When configured, puppeteer will skip the browser launch and connect to the browser instance. Can also be set globally via environment variables: `PUPPETEER_BROWSER_WS_ENDPOINT` or `PUPPETEER_WS_ENDPOINT`.
      - **Protocol**: The protocol to use when connecting to the browser. Options:
        - **CDP (Chrome DevTools Protocol)** - Default for Chrome/Chromium
        - **WebDriver BiDi** - For Firefox and cross-browser automation
        Can also be set globally via environment variable: `PUPPETEER_PROTOCOL`.
      - **Emulate Device**: Allows you to specify a [device](https://github.com/puppeteer/puppeteer/blob/main/src/common/DeviceDescriptors.ts) to emulate when requesting the page.
      - **Executable Path**: A path where Puppeteer expects to find the bundled browser. Has no effect when 'Browser WebSocket Endpoint' is set.
      - **Extra Headers**: Allows you add additional headers when requesting the page.
      - **Timeout**: Allows you to specify the maximum navigation time in milliseconds. You can pass 0 to disable the timeout entirely.
      - **Protocol Timeout**: Maximum time in milliseconds to wait for a protocol response. Pass 0 to disable timeout.
      - **Wait Until**: Allows you to change how Puppeteer considers navigation completed.
        - `load`: The load event is fired.
        - `domcontentloaded`: The DOMContentLoaded event is fired.
        - `networkidle0`: No more than 0 connections for at least 500 ms.
        - `networkidle2`: No more than 2 connections for at least 500 ms.
      - **Page Caching**: Allows you to toggle whether pages should be cached when requesting.
      - **Headless mode**: Allows you to change whether to run browser runs in headless mode or not.
      - **Use Chrome Headless Shell**: Whether to run browser in headless shell mode. Defaults to false. Headless mode must be enabled. chrome-headless-shell must be in $PATH.
      - **Stealth mode**: When enabled, applies various techniques to make detection of headless Puppeteer harder. Powered by [puppeteer-extra-plugin-stealth](https://github.com/berstend/puppeteer-extra/tree/master/packages/puppeteer-extra-plugin-stealth).
      - **Human typing mode**: Gives page the function `.typeHuman()` which "humanizes" the writing of input elements. Includes configurable options for typing speed, typos, and backspace delays.
      - **Launch Arguments**: Allows you to specify additional command line arguments passed to the browser instance.
      - **Capture Downloads**: When enabled, any files downloaded during script execution (via clicks, direct downloads, etc.) will be automatically captured and returned as binary data in the node output. Perfect for downloading PDFs, images, or other files triggered by user interactions. Files are automatically cleaned up after capture.
      - **Add Container Arguments**: Automatically adds recommended arguments for container environments (`--no-sandbox`, `--disable-setuid-sandbox`, `--disable-dev-shm-usage`, `--disable-gpu`). Container environments are auto-detected by default. Disable only if you experience launch issues.
      - **Proxy Server**: Allows Puppeteer to use a custom proxy configuration. You can specify a custom proxy configuration in three ways:
        By providing a semi-colon-separated mapping of list scheme to url/port pairs.
        For example, you can specify:

              http=foopy:80;ftp=foopy2

        to use HTTP proxy "foopy:80" for http URLs and HTTP proxy "foopy2:80" for ftp URLs.

        By providing a single uri with optional port to use for all URLs.
        For example:

              foopy:8080

        will use the proxy at foopy:8080 for all traffic.

        By using the special "direct://" value.

              direct://" will cause all connections to not use a proxy.

    - Get PDF
      - **File Name**: Allows you to specify the filename of the output file.
      - **Page Ranges** field: Allows you to specify paper ranges to print, e.g. 1-5, 8, 11-13.
      - **Scale**: Allows you to scale the rendering of the web page. Amount must be between 0.1 and 2
      - **Prefer CSS Page Size**: Give any CSS @page size declared in the page priority over what is declared in the width or height or format option.
      - **Format**: Allows you to specify the paper format types when printing a PDF. eg: Letter, A4.
      - **Height**: Allows you to set the height of paper. You can pass in a number or a string with a unit.
      - **Width**: Allows you to set the width of paper. You can pass in a number or a string with a unit.
      - **Landscape**: Allows you to control whether to show the header and footer
      - **Margin**: Allows you to specify top, left, right, and bottom margin.
      - **Display Header/Footer**: Allows you to specify whether to show the header and footer.
      - **Header Template**: Allows you to specify the HTML template for the print header. Should be valid HTML with the following classes used to inject values into them:
        - `date`: Formatted print date
        - `title`: Document title
        - `url`: Document location
        - `pageNumber` Current page number
        - `totalPages` Total pages in the document
      - **Footer Template**: Allows you to specify the HTML template for the print footer. Should be valid HTML with the following classes used to inject values into them:
        - `date`: Formatted print date
        - `title`: Document title
        - `url`: Document location
        - `pageNumber` Current page number
        - `totalPages` Total pages in the document
      - **Transparent Background**: Allows you to hide the default white background and allows generate PDFs with transparency.
      - **Background Graphic**: Allows you to include background graphics.
    - Get Screenshot
      - **File Name**: Allows you to specify the filename of the output file.
      - **Type** field: Allows you to specify the image format of the output file:
        - JPEG
        - PNG
        - WebP
      - **Quality**: Allows you to specify the quality of the image.
        - Accepts a value between 0-100.
        - Not applicable to PNG images.
      - **Full Page**: Allows you to capture a screen of the full scrollable content.

  ## Custom Scripts

  The Custom Script operation gives you complete control over Puppeteer to automate complex browser interactions, scrape data, generate PDFs/screenshots, and more. Scripts run in a sandboxed environment with access to the full Puppeteer API and n8n's Code node features.

  Before script execution, you can configure browser behavior using the operation's options like:

  - Emulate specific devices
  - Set custom headers
  - Enable stealth mode to avoid detection
  - Configure proxy settings
  - Set page load timeouts
  - And more

  Access Puppeteer-specific objects using:

  - `$page` - Current page instance
  - `$browser` - Browser instance
  - `$puppeteer` - Puppeteer library
  - `$input.query` - Input query from AI agents (when used as a tool)

  Plus all special variables and methods from the Code node are available. For a complete reference, see the [n8n documentation](https://docs.n8n.io/code-examples/methods-variables-reference/). Just like n8n's Code node, anything you `console.log` will be shown in the browser's console during test mode or in stdout when configured.

  ### AI Agent Integration

  When used as a tool by n8n AI agents, this node supports two powerful workflows:

  **1. AI-Generated Scripts**: AI agents can dynamically generate the entire Puppeteer script using `$fromAI()` on the Script Code parameter. The AI analyzes the task and writes the appropriate Puppeteer code to accomplish it.

  ```javascript
  // AI agent generates script dynamically based on the task
  scriptCode: $fromAI('code', 'Generate a Puppeteer script to extract product prices from the homepage')
  ```

  **2. Reusable Scripts with AI Input**: Write a reusable script that accepts dynamic input from AI agents via the Query parameter. Access the input using `$input.query` in your script.

  ```javascript
  // Reusable script that processes AI-provided input
  const url = $input.query || 'https://example.com';
  await $page.goto(url);

  const data = await $page.evaluate(() => {
    return document.querySelector('h1').textContent;
  });

  return [{ url, title: data }];
  ```

  ```javascript
  // AI agent provides input dynamically
  query: $fromAI('url', 'The website URL to scrape')
  ```

  This makes the node extremely flexible for AI-powered automation - agents can either write custom scripts for specific tasks or pass data to pre-built, reusable scripts.

  ### Basic

  ```javascript
  // Navigate to an IP lookup service
  await $page.goto("https://httpbin.org/ip");

  // Extract the IP address from the page content
  const ipData = await $page.evaluate(() => {
    const response = document.body.innerText;
    const parsed = JSON.parse(response);
    return parsed.origin; // Extract the 'origin' field, which typically contains the IP address
  });

  console.log("Hello, world!");

  console.log("IP Address", ipData);

  // Return the result in the required format (array)
  return [{ ip: ipData, ...$json }];
  ```

  ### Storing and re-using cookies

  #### Node 1

  ```javascript
  await $page.goto("https://www.example.com/login");

  // Perform login
  await $page.type("#login-username", "user");
  await $page.type("#login-password", "pass");
  await $page.click("#login-button");

  // Store cookies for later use
  const cookies = await $page.cookies();

  return [{ cookies }];
  ```

  #### Node 2

  ```javascript
  const { cookies } = $input.first().json;

  // Restore cookies
  await $page.setCookie(...cookies);

  // Navigate to authenticated page
  await $page.goto("https://example.com/protected-page");

  // Perform authenticated operations
  const data = await $page.evaluate(() => {
    return document.querySelector(".protected-content").textContent;
  });

  return [{ data }];
  ```

  ### Working with Binary Data

  ```javascript
  await $page.goto("https://www.google.com");
  const imageData = await $page.screenshot({ type: "png", encoding: "base64" });
  return [
    {
      binary: {
        screenshot: {
          data: imageData,
          mimeType: "image/png",
          fileName: "screenshot.png",
        },
      },
    },
  ];
  ```

  ### Downloading Files

  The Capture Downloads option makes it easy to download files triggered by user interactions or scripts:

  ```javascript
  // Navigate to a page with downloadable files
  await $page.goto('https://example.com/downloads');

  // Click a download button - the file will be automatically captured
  await $page.click('#download-pdf-button');

  // Wait a moment for the download to complete
  await $page.waitForTimeout(2000);

  // Return the result - downloaded files will be attached as binary data
  return [{ json: { success: true } }];
  ```

  When the "Capture Downloads" option is enabled:
  - All files downloaded during script execution are automatically captured
  - Files are returned as binary data in the node output
  - Multiple files are supported - each file gets its own binary property
  - Files are automatically cleaned up after capture
  - Works with direct downloads, click-triggered downloads, and programmatic downloads

  This is particularly useful for:
  - Downloading PDFs from web applications
  - Capturing generated reports
  - Saving images or documents triggered by user actions
  - Testing download functionality in automated workflows

  ## Environment Variables

  The following environment variables can be used to configure Puppeteer globally:

  - **`PUPPETEER_BROWSER_WS_ENDPOINT`** or **`PUPPETEER_WS_ENDPOINT`**: WebSocket URL of the browser to connect to. This eliminates the need to configure each node individually.
  - **`PUPPETEER_PROTOCOL`**: Protocol to use (`cdp` or `webDriverBiDi`). Useful for Firefox setups.
  - **`PUPPETEER_SKIP_CHROMIUM_DOWNLOAD`**: Set to `true` to skip downloading Chromium during installation.
  - **`PUPPETEER_EXECUTABLE_PATH`**: Path to the browser executable.

  Example:
  ```bash
  docker run -it -p 5678:5678 \
    -e PUPPETEER_BROWSER_WS_ENDPOINT=ws://browserless:3000 \
    -e PUPPETEER_PROTOCOL=cdp \
    n8n-puppeteer
  ```

  Node-level settings always override environment variables when specified.

  ## Firefox Support

  This node supports Firefox through WebDriver BiDi protocol. To use Firefox:

  1. Set up a Firefox instance with WebDriver BiDi enabled
  2. Configure the connection either:
     - **Per-node**: Options > Browser WebSocket Endpoint + Protocol (WebDriver BiDi)
     - **Globally**: Environment variables `PUPPETEER_BROWSER_WS_ENDPOINT` + `PUPPETEER_PROTOCOL=webDriverBiDi`
  3. Execute your workflows with Firefox!

  ## Screenshots

  ### Run Custom Script

  ![](images/script.png)

  ### Get Page Content

  ![](images/content.png)

  ### Get Screenshot

  ![](images/screenshot.png)

  ## License

  MIT License

  Copyright (c) 2022-2024 Nicholas Penree <nick@penree.com>

  Permission is hereby granted, free of charge, to any person obtaining a copy
  of this software and associated documentation files (the "Software"), to deal
  in the Software without restriction, including without limitation the rights
  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
  copies of the Software, and to permit persons to whom the Software is
  furnished to do so, subject to the following conditions:

  The above copyright notice and this permission notice shall be included in all
  copies or substantial portions of the Software.

  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
  SOFTWARE.

ai_documentation_summary:
  {"purpose":"A n8n node for browser automation using Puppeteer that enables executing custom scripts, capturing screenshots and PDFs, scraping content, and automating web interactions via Chrome/Chromium's DevTools Protocol.","capabilities":["Execute custom scripts on web pages","Capture full page screenshots","Capture partial page screenshots","Export page content as PDF","Get full HTML contents of a page","Scrape web content","Automate web interactions","Full Puppeteer API access","Support for Chrome DevTools Protocol (CDP)","Support for Firefox via WebDriver BiDi"],"authentication":"None - Uses local Chromium or remote browser WebSocket endpoints (e.g., browserless) with optional token authentication for remote services","commonUseCases":["Web scraping and data extraction","Automated testing and validation","Screenshot generation for documentation","PDF report generation from web pages","Cloud deployment without local browser dependencies"],"limitations":["Requires Chromium or Firefox dependencies when running locally (unless using remote browser)","Local installation increases package size and may require system dependencies","Remote browser setups require external service configuration or self-hosted browser instances","Containerized environments require specific launch arguments for Chrome"],"relatedNodes":["n8n Code node","n8n HTTP Request node","n8n Webhook node"]}


node_type: n8n-nodes-wts.wts
package_name: n8n-nodes-wts
display_name: wts
description: n8n node to call wts services
category: Community
development_style: declarative
version: 2.0.5
properties_schema: []
operations: []
credentials_required: []
updated_at: 2026-04-16 09:43:37
author_name: wts-chat
author_github_url: git+https://github.com/wtschat/n8n-nodes.git
npm_package_name: n8n-nodes-wts
npm_version: 2.0.5
community_fetched_at: 2026-04-16T09:43:37.357Z
ai_summary_generated_at: 2026-03-25 22:47:20
npm_readme:
  ![Banner image](https://user-images.githubusercontent.com/10284570/173569848-c624317f-42b1-45a6-ab09-f0ea3c247648.png)

  # n8n-nodes-wts
  Este é um nó Wts Chat, que permite que você use o Wts Chat em seus fluxos de trabalho no n8n.
  Vai facilitar suas automações com a plataforma Wts Chat, de forma rápida, prática e eficiente.
  Permitindo que os usuários criem contatos, notas em um cartão, enviem mensagens de texto, modelos e muito mais.

  # Release Notes
  Atualização do Wts Chat – Versão 2.0.2   19/03/2025

  A nova versão 2.0.2 do nó do Wts Chat traz melhorias e ajustes importantes em diversos módulos. Confira as principais mudanças desta atualização:

  **Módulo Update Card**
  ✅Edição do campo Metadata: Agora, é possível editar apenas o campo Metadata sem a necessidade de modificar outros dados do card.
  ✅Campo Custom Fields de Multiseleção: Para campos do tipo multiseleção, é possível selecionar várias opções separando os valores por vírgulas (exemplo: 1, 2, 3), garantindo mais flexibilidade na escolha de múltiplos valores.

  **Módulo Update Session**
  ✅Novidade: Possibilidade de atribuir valores vazios ('Empty') para usuário e departamento, permitindo alterações independentes:

  Usuário: Agora pode ser atualizado separadamente, bastando definir o valor como ‘Empty’.
  Departamento: Pode ser modificado sem afetar o usuário.
  Usuário e Departamento: Ambos podem ser alterados simultaneamente.
  🚫Remoção do campo 'CompanyId': Esse campo não estará mais disponível na atualização de conversa.

  **Módulo Transfer Session To User**
  🔄Renomeação do módulo: O nome foi atualizado de "Assign user to session" para "Transfer session to user", tornando a ação mais clara e intuitiva.

  **Módulo Complete Session**
  🔄Renomeação do módulo: O nome foi alterado de "Conclude session" para "Complete session".

  **Módulo List Annotations**
  🔄Renomeação do módulo: O nome foi atualizado de "List notes" para "List annotations".

  -----------------------------------------------------------------------------------------------------------------------

  Atualização do Wts Chat – Versão 2.0.3   02/02/2025
    
  A nova versão 2.0.3 do nó do Wts Chat traz os seguintes ajustes ao nó "Send Chatbot".

  ✅Campo "From Name or ID": Esse campo é possível passar o valor como expressão.
  🚫Remoção de validações dos campos.

  -----------------------------------------------------------------------------------------------------------------------

  Atualização do Wts Chat – Versão 2.0.4   27/05/2025

  A nova versão 2.0.4 do nó do Wts Chat traz um ajuste importante no módulo "Send Chatbot", focando na melhoria da identificação dos chatbots disponíveis para envio. A identificação sendo a chave e não mais o id.

  **Módulo Send Chatbot**
  🔄Listagem de Chatbots: Agora, a listagem de chatbots utiliza como valor a chave (key) do chatbot, e não mais o Id.
  🔄Envio da Chave: A chamada ao módulo agora envia a chave do chatbot selecionado, substituindo o envio do Id, garantindo maior consistência com os dados utilizados na plataforma.

  -----------------------------------------------------------------------------------------------------------------------

  Atualização do Wts Chat – Versão 2.0.5 13/08/2025
  A nova versão 2.0.5 do nó do Wts Chat traz correções importantes no integrador N8N. Veja as principais mudanças:

  **Módulo Complete Session**
  ✅Foi adicionado o parâmetro stopBotInExecution, permitindo que o bot seja interrompido ao concluir a sessão.

  **Módulo Create Contact**
  ✅O parâmetro Portfolio (Carteira) foi adicionado, agora permitindo associar um contato a uma carteira específica durante a criação.

  **Módulo List Contacts**
  Endpoint "Get All Contacts": Foi incluído o parâmetro includeDetails para o portfolio, permitindo que os detalhes da carteira sejam retornados ao consultar todos os contatos.



  <h1></h1>
  <h3>📌 Recurso: Contato</h3>

  <details>
    <summary>✅ <b> Criar Contato</b></summary>
  </details>

  <details>
    <summary>✅ <b> Atualizar Contato</b></summary>
  </details> 

  <details>
    <summary>✅ <b> Buscar Contato por ID</b></summary>
  </details>

  <details>
    <summary>✅ <b> Buscar Contato por Telefone</b></summary>
  </details>

  <details>
    <summary>✅ <b> Listar Contatos</b></summary>
  </details>

  <h1></h1>
  <h3>📌 Recurso: Mensagem</h3>

  <details>
    <summary>✅ <b> Enviar Texto</b></summary>
  </details>

  <details>
    <summary>✅ <b> Enviar Arquivo</b></summary>
  </details>

  <details>
    <summary>✅ <b> Enviar Modelo de Mensagem</b></summary>
  </details>


  <details>
    <summary>✅ <b> Buscar Mensagem por ID</b></summary>
  </details>

  <h1></h1>
  <h3>📌 Recurso: Conversa</h3>
  <details>
  <summary>✅ <b> Listar Conversas</b></summary>
  </details>
  <details>
  <summary>✅ <b> Atualizar Transferência</b></summary>
  </details>
  <details>
  <summary>✅ <b> Atualizar Status da Conversa</b></summary>
  </details>
  <details>
  <summary>✅ <b> Buscar Conversa por ID</b></summary>
  </details>
  <details>
  <summary>✅ <b> Atribuir Usuário à Conversa</b></summary>
  </details> 
  <details>
  <summary>✅ <b> Concluir Conversa</b></summary>
  </details>
  <details>
  <summary>✅ <b> Atualizar Conversa</b></summary>
  </details>
  <details>
  <summary>✅ <b> Enviar Mensagem de Texto</b></summary>
  </details>
  <details>
  <summary>✅ <b> Enviar Mensagem com Arquivo</b></summary>
  </details>
  <details>
  <summary>✅ <b> Enviar Modelo de Mensagem</b></summary>
  </details>

  <h1></h1>
  <h3>📌 Recurso: Painel</h3>
  <details>
  <summary>✅ <b> Listar Anotações</b></summary>
  </details>
  <details>
  <summary>✅ <b> Listar Cards</b></summary>
  </details>
  <details>
  <summary>✅ <b> Listar Painéis</b></summary>
  </details>
  <details>
  <summary>✅ <b> Buscar Card por ID</b></summary>
  </details>
  <details>
  <summary>✅ <b> Buscar Painel por ID</b></summary>
  </details>
  <details>
  <summary>✅ <b> Criar Card</b></summary>
  </details>
  <details>
  <summary>✅ <b> Criar Anotação de Texto</b></summary>
  </details>
  <details>
  <summary>✅ <b> Criar Anotação de Arquivo</b></summary>
  </details>
  <details>
  <summary>✅ <b> Deletar Anotação de Card</b></summary>
  </details>
  <details>
  <summary>✅ <b> Duplicação de Card</b></summary>
  </details>
  <details>
  <summary>✅ <b> Atualização de Card</b></summary>
  </details>

  <h1></h1>
  <h3>📌 Recurso: Chatbot</h3>
  <details>
  <summary>✅ <b> Enviar Chatbot</b></summary>
  </details>

  <h1></h1>
  <h3>📌 Recurso: Sequência</h3>
  <details>
  <summary>✅ <b> Adicionar Contato à sequência</b></summary>
  </details>
  <details>
  <summary>✅ <b> Adicionar Contatos à sequência</b></summary>
  </details>
  <details>
  <summary>✅ <b> Remover Contato de uma sequência</b></summary>
  </details>
  <details>
  <summary>✅ <b> Remover Contatos de uma sequência</b></summary>
  </details>
  <details>
  <summary>✅ <b> Listar Sequências</b></summary>
  </details>
  <details>
  <summary>✅ <b> Listar Contatos de uma Sequência</b></summary>
  </details>

  <h1></h1>

  # Instalação

  #### Siga o guia de instalação nos nós da comunidade n8n.

   - Vá para Configurações > Nós da comunidade.

  - Selecione Instalar.

  - Digite o nome do pacote: **n8n-nodes-wts**

  - Depois de instalado, você pode criar um fluxo de trabalho e no painel de nós, pesquisar por: **WTS Chat**

  - Com isso você poderá visualizar as ações disponíveis com o nó.

ai_documentation_summary:
  {"purpose":"This n8n node enables automation workflows to interact with the Wts Chat platform, allowing users to manage contacts, messages, sessions, and dashboard cards.","capabilities":["Create contacts","Update contacts","Search contacts by ID or phone","List all contacts","Send text messages","Send files","Send message templates","Retrieve messages by ID","List conversations","Update session transfers"],"authentication":"API key required","commonUseCases":["Automating customer support interactions via Wts Chat","Managing CRM contacts and notes within n8n workflows","Sending automated messages and files to users","Tracking and updating conversation statuses","Organizing dashboard cards and annotations"],"limitations":["Removal of 'CompanyId' field in session updates","Validation fields removed in version 2.0.3","Chatbot identification now relies on key rather than ID"],"relatedNodes":["n8n-nodes-http.request","n8n-nodes-wts.wts","n8n-nodes-wts.wts"]}


node_type: @asaasbr/n8n-nodes-asaas.asaas
package_name: @asaasbr/n8n-nodes-asaas
display_name: asaas
description: n8n nodes for integrating with the Asaas API
category: Community
development_style: declarative
version: 1.1.3
properties_schema: []
operations: []
credentials_required: []
updated_at: 2026-04-16 09:43:37
author_name: asaas-pagamentos
author_github_url: git+https://github.com/asaasdev/n8n-plugin-asaas.git
npm_package_name: @asaasbr/n8n-nodes-asaas
npm_version: 1.1.3
community_fetched_at: 2026-04-16T09:43:37.358Z
ai_summary_generated_at: 2026-03-25 22:47:20
npm_readme:
  # Módulo Asaas para N8N



  Nó oficial de N8N para integração com a [API do Asaas](https://docs.asaas.com/).
  Este módulo permite automatizar cobranças, gestão de clientes e notificações diretamente em seus fluxos de trabalho no [n8n](https://n8n.io).



  ## Recursos Implementados



  Atualmente, o módulo oferece suporte aos seguintes grupos de recursos da API Asaas:



  - 👥 **Clientes**: criação, listagem, atualização, exclusão e restauração de clientes.

  - 💰 **Cobranças (Payments)**: emissão e consulta de cobranças, incluindo suporte a PIX, boleto e cartão de crédito.

  - 🔔 **Notificações**: configuração e gerenciamento de notificações automáticas.

  - 📄 **Assinaturas e Parcelamentos**: gestão de recorrências e planos parcelados.

  - 💳 **Transações PIX**: criação de cobranças PIX e emissão de QR Codes.

  - 📊 **Financeiro e Relatórios**: extrato, antecipações e estatísticas de faturamento.

  - ⚙️ **Conta e Configurações**: dados comerciais, personalização e webhooks.



  ## Rotas de API utilizadas



  -  *Produção*: [https://api.asaas.com/v3](https://api.asaas.com/v3)

  -  *Sandbox*: [https://api-sandbox.asaas.com/v3](https://api-sandbox.asaas.com/v3)



  ## Instalação



  Via **npm** (recomendado):

  ```bash

  npm install @asaasbr/n8n-nodes-asaas

  ```



  Via **Community Nodes** no n8n:
  📖 **Documentação oficial:**  
  https://docs.asaas.com/docs/n8n

  1. Acesse *Settings → Community Nodes*

  2. Clique em *Install a community node*

  3. Digite: `@asaasbr/n8n-nodes-asaas`

  4. Clique em *Install*



  ## Pré-requisitos



  - Conta no [Asaas](https://asaas.com) (produção ou sandbox)

  - API Key ativa (obtida no painel Asaas)

  - n8n versão `>=1.0.0`

  - Node.js versão `>=20.15`



  ## Configuração



  1. No n8n, vá em **Credentials → Add Credential**

  2. Procure por **Asaas API**

  3. Preencha:

  - API Key: sua chave do Asaas

  - Ambiente: *Sandbox* (testes) ou *Produção*

  4. Teste a conexão e salve

  ## Feedback e Sugestões

  Encontrou algum bug ou tem uma ideia de melhoria?  
  Contribua para tornar este módulo ainda melhor :rocket:

  [https://forms.gle/Hbo5JhEZHJHVSrYH7](https://forms.gle/Hbo5JhEZHJHVSrYH7)


  ## Licença



  MIT

ai_documentation_summary:
  {"purpose":"This n8n node enables integration with the Asaas API to automate financial operations including billing, customer management, and notifications within n8n workflows.","capabilities":["Create, list, update, delete, and restore clients","Issue and query invoices supporting PIX, boleto, and credit card","Configure and manage automatic notifications","Manage subscriptions and installment plans","Create PIX invoices and generate QR Codes","Access financial reports, statements, and revenue statistics","Manage commercial data and webhook configurations"],"authentication":"API Key required","commonUseCases":["Automating invoice generation and payment collection","Managing customer databases and billing cycles","Sending automated payment reminders and notifications","Processing PIX transactions and QR Code generation"],"limitations":["Requires Node.js version >=20.15","Requires an active Asaas account with API Key access"],"relatedNodes":["n8n HTTP Request","n8n Webhook","n8n Credential Manager"]}


node_type: n8n-nodes-deepseek.deepseek
package_name: n8n-nodes-deepseek
display_name: deepseek
category: Community
development_style: declarative
version: 1.0.6
properties_schema: []
operations: []
credentials_required: []
updated_at: 2026-04-16 09:43:37
author_name: rubickecho
author_github_url: git+https://github.com/rubickecho/n8n-deepseek.git
npm_package_name: n8n-nodes-deepseek
npm_version: 1.0.6
community_fetched_at: 2026-04-16T09:43:37.359Z
ai_summary_generated_at: 2026-03-25 22:47:20
description:
  A user-friendly DeepSeek AI node, similar to OpenAI, designed to enhance your workflow. npm link: https://www.npmjs.com/package/n8n-nodes-deepseek

npm_readme:
  ![Banner image](https://user-images.githubusercontent.com/10284570/173569848-c624317f-42b1-45a6-ab09-f0ea3c247648.png)

  # n8n-nodes-deepseek

  This is an n8n community node. It lets you use DeepSeek AI in your n8n workflows.

  DeepSeek-V2 delivers impressive results on current major large model leaderboards.

  DeepSeek WebSite: https://www.deepseek.com/en


  [n8n](https://n8n.io/) is a [fair-code licensed](https://docs.n8n.io/reference/license/) workflow automation platform.

  - [Installation](#installation)  
  - [Credentials](#credentials)
  - [Usage](#usage)
  - [Resources](#resources)  

  ## Installation

  Follow the [installation guide](https://docs.n8n.io/integrations/community-nodes/installation/) in the n8n community nodes documentation.

  Use the package at [here](https://www.npmjs.com/package/n8n-nodes-deepseek).

  ## Credentials
  Add your Api Key and store securely

  ![Add Credentials](images/credentials.jpg)

  ## Usage

  Add a DeepSeek node to your workflow, select the action you want to perform, and enter the required fields.

  ![Workflow](images/workflow.jpg)

  Run the workflow, and the result will be displayed in the Run Result node.

  ![Run Result](images/run-result.jpg)

  ### A Simple Demo

  ```json
  {
    "meta": {
      "instanceId": "8419fa436e34f85077f6eb7f63a9c97687d9df6ed55cfc53d58b3b86ab6d8e61"
    },
    "nodes": [
      {
        "parameters": {},
        "id": "a8c5f656-680b-4e43-b626-d3c85b1e21a1",
        "name": "When clicking ‘Test workflow’",
        "type": "n8n-nodes-base.manualTrigger",
        "typeVersion": 1,
        "position": [
          920,
          480
        ]
      },
      {
        "parameters": {
          "model": "deepseek-chat",
          "prompt": {
            "messages": [
              {
                "role": "system",
                "content": "I want you to act as a etymologist. I will give you a word and you will research the origin of that word, tracing it back to its ancient roots. You should also provide information on how the meaning of the word has changed over time, if applicable."
              },
              {
                "content": "={{ $json.prompt }}"
              }
            ]
          },
          "options": {},
          "requestOptions": {}
        },
        "id": "4841b428-7848-42d1-a0c6-f28c01a07010",
        "name": "DeepSeek",
        "type": "n8n-nodes-deepseek.deepSeek",
        "typeVersion": 1,
        "position": [
          1380,
          480
        ],
        "credentials": {
          "deepSeekApi": {
            "id": "WWBInhkKqwf808n4",
            "name": "DeepSeek account"
          }
        }
      },
      {
        "parameters": {
          "assignments": {
            "assignments": [
              {
                "id": "1b94a0dc-9b9b-4302-a1fd-2ac41b876740",
                "name": "prompt",
                "value": "My word is \"pizza\"",
                "type": "string"
              }
            ]
          },
          "options": {}
        },
        "id": "6e6054b0-bcb4-4fe3-83be-01cd7da39d93",
        "name": "Edit Fields",
        "type": "n8n-nodes-base.set",
        "typeVersion": 3.4,
        "position": [
          1160,
          480
        ]
      }
    ],
    "connections": {
      "When clicking ‘Test workflow’": {
        "main": [
          [
            {
              "node": "Edit Fields",
              "type": "main",
              "index": 0
            }
          ]
        ]
      },
      "Edit Fields": {
        "main": [
          [
            {
              "node": "DeepSeek",
              "type": "main",
              "index": 0
            }
          ]
        ]
      }
    },
    "pinData": {}
  }
  ```

  ## Resources

  - [n8n community nodes documentation](https://docs.n8n.io/integrations/community-nodes/)


  ## License

  [MIT](https://github.com/n8n-io/n8n-nodes-starter/blob/master/LICENSE.md)

ai_documentation_summary:
  {"purpose":"A community n8n node that integrates with the DeepSeek AI API to perform text generation and other LLM tasks within workflow automation.","capabilities":["Text generation via chat models (e.g., deepseek-chat)","Support for system prompts and multi-turn conversations","Dynamic prompt injection using n8n expressions","Integration with DeepSeek API for large model inference"],"authentication":"API key required (stored in node credentials)","commonUseCases":["Automated customer support responses","Content generation and summarization","Data analysis and text processing","Workflow automation with natural language understanding"],"limitations":["Community node (may lack official support compared to n8n core nodes)","Dependent on DeepSeek API availability and rate limits","Requires manual installation via npm package"],"relatedNodes":["n8n-nodes-base.manualTrigger","n8n-nodes-base.set","n8n-nodes-base.runResult","n8n-nodes-base.if"]}


node_type: @nectopro/n8n-nodes-nano-banana.nanobanana
package_name: @nectopro/n8n-nodes-nano-banana
display_name: nanobanana
description: Nano Banana Node for n8n
category: Community
development_style: declarative
version: 0.1.12
properties_schema: []
operations: []
credentials_required: []
updated_at: 2026-04-16 09:43:37
author_name: necto-pro
author_github_url: git+https://github.com/necto-pro/n8n-nodes-nano-banana.git
npm_package_name: @nectopro/n8n-nodes-nano-banana
npm_version: 0.1.12
community_fetched_at: 2026-04-16T09:43:37.359Z
npm_readme:
  # n8n-nodes-nano-banana

  This is an n8n community node that integrates Google's Gemini AI models for advanced text and image generation capabilities. It lets you use Nano Banana (powered by Gemini AI) in your n8n workflows for creating images, analyzing visual content, and generating text responses.

  Google Gemini AI is a powerful multimodal AI platform that can understand and generate both text and images, making it perfect for creative workflows, content generation, and AI-powered automation.

  [n8n](https://n8n.io/) is a [fair-code licensed](https://docs.n8n.io/reference/license/) workflow automation platform.

  ## Table of Contents

  [Installation](#installation)  
  [Operations](#operations)  
  [Credentials](#credentials)  
  [Getting Started](#getting-started)  
  [Usage Examples](#usage-examples)  
  [Compatibility](#compatibility)  
  [Resources](#resources)  
  [Contributing](#contributing)  
  [License](#license)  

  ## Installation

  Follow the [installation guide](https://docs.n8n.io/integrations/community-nodes/installation/) in the n8n community nodes documentation.

  ### Install via npm

  ```bash
  npm install @nectopro/n8n-nodes-nano-banana
  ```

  ### Install in n8n

  1. Go to **Settings > Community Nodes**
  2. Select **Install**
  3. Enter `@nectopro/n8n-nodes-nano-banana`
  4. Agree to the risks of using community nodes
  5. Select **Install**

  After installation restart n8n to use the new nodes.

  ## Operations

  The Nano Banana node supports the following operations:

  ### Generate Content
  - **Text Generation**: Create written content, stories, code, and more
  - **Image Generation**: Generate images from text descriptions
  - **Image Analysis**: Analyze and describe uploaded images
  - **Multimodal Conversations**: Combine text and images in interactive dialogues
  - **Creative Tasks**: Logo design, artwork, technical diagrams, and illustrations
  - **JSON Input Format**: Provide message history and current message as JSON for programmatic workflows

  ### Key Features
  - Support for multiple content types (text, images via URL or base64)
  - Conversation history management
  - Streaming responses for real-time processing
  - Multiple response modalities (text, images, or both)
  - Advanced configuration options (temperature, tokens, etc.)
  - Comprehensive error handling
  - Flexible input formats (Manual UI mapping or JSON)

  ## Credentials

  To use this node, you need a Google AI Studio API key.

  ### Getting Your API Key

  1. **Visit Google AI Studio**
     - Go to [Google AI Studio](https://makersuite.google.com/app/apikey)
     - Sign in with your Google account

  2. **Create API Key**
     - Click "Create API Key"
     - Choose "Create API key in new project" or select an existing project
     - Copy the generated API key (starts with `AIza...`)

  3. **Configure in n8n**
     - In your n8n workflow, add the Nano Banana node
     - Click on the credential field
     - Select "Create New"
     - Choose "AI Studio Credentials API"
     - Paste your API key
     - Save the credential

  ### Important Notes
  - Keep your API key secure and never share it publicly
  - Google AI Studio has usage limits and quotas
  - Some features may require billing to be enabled in Google Cloud
  - The API key provides access to Gemini models including image generation capabilities

  ## Getting Started

  ### Input Format Options

  The node supports two input formats that can be selected in the node settings:

  1. **Manual Mapping**: Use the UI fields to define message history and current message
  2. **JSON Format**: Provide all input data as a JSON object in the "JSON Input" field

  ### JSON Input Format

  When using JSON format, provide a JSON object with the following structure:

  ```json
  {
    "messageHistory": [
      {
        "contentType": "text",
        "text": "What's in this image?",
        "role": "user"
      },
      {
        "contentType": "imageUrl",
        "imageUrl": "https://example.com/image.jpg",
        "mimeType": "image/jpeg",
        "role": "user"
      },
      {
        "contentType": "text",
        "text": "This is a beautiful landscape with mountains and a lake.",
        "role": "model"
      }
    ],
    "currentMessage": "Can you describe the colors in more detail?"
  }
  ```

  ### Basic Text Generation

  1. Add a **Nano Banana** node to your workflow
  2. Set up your **AI Studio Credentials**
  3. Select **Generate Image** operation
  4. Choose **Nano Banana Image** model
  5. Select **JSON Format** if you want to use JSON input, or keep **Manual Mapping**
  6. Enter your prompt in **Current Message** (Manual) or **JSON Input** (JSON)
  7. Set **Response Modalities** to **TEXT**
  8. Execute the node

  ### Basic Image Generation

  1. Follow steps 1-5 from above
  2. Enter an image description prompt
  3. Set **Response Modalities** to **IMAGE**
  4. Execute to generate an image

  ### Image Analysis

  1. Add the node and configure credentials
  2. Select input format (Manual or JSON)
  3. For Manual: In **Message History**, add a message with:
     - **Content Type**: Image (URL) or Image (Base64)
     - **Image URL** or **Image Base64** data
     - **Role**: User
  4. For JSON: Include image data in the JSON input
  5. Set **Current Message** to your question about the image
  6. Set **Response Modalities** to **TEXT**
  7. Execute to get image analysis

  ## Usage Examples

  ### Example 1: Creative Writing
  ```json
  {
    "operation": "generateContent",
    "model": "gemini-2.5-flash-image-preview",
    "currentMessage": "Write a short story about a robot learning to paint",
    "responseModalities": ["TEXT"]
  }
  ```

  ### Example 2: Logo Design
  ```json
  {
    "operation": "generateContent", 
    "model": "gemini-2.5-flash-image-preview",
    "currentMessage": "Create a modern, minimalist logo for a coffee shop called 'Morning Brew'",
    "responseModalities": ["IMAGE", "TEXT"]
  }
  ```

  ### Example 3: Image Analysis
  ```json
  {
    "operation": "generateContent",
    "model": "gemini-2.5-flash-image-preview",
    "messageHistory": {
      "messages": [{
        "role": "user",
        "contentType": "imageUrl",
        "imageUrl": "https://example.com/photo.jpg",
        "mimeType": "image/jpeg"
      }]
    },
    "currentMessage": "What objects do you see in this image?",
    "responseModalities": ["TEXT"]
  }
  ```

  ### Example 4: Conversation with Context
  ```json
  {
    "operation": "generateContent",
    "model": "gemini-2.5-flash-image-preview", 
    "messageHistory": {
      "messages": [
        {
          "role": "user",
          "contentType": "text",
          "text": "I need help designing a website"
        },
        {
          "role": "model", 
          "contentType": "text",
          "text": "I'd be happy to help! What type of website are you looking to create?"
        }
      ]
    },
    "currentMessage": "It's for a photography portfolio",
    "responseModalities": ["TEXT"]
  }
  ```

  ### Example 5: JSON Input Format
  ```json
  {
    "operation": "generateContent",
    "model": "gemini-2.5-flash-image-preview",
    "inputFormat": "json",
    "jsonInput": "{\n  \"messageHistory\": [\n    {\n      \"contentType\": \"text\",\n      \"text\": \"What's in this image?\",\n      \"role\": \"user\"\n    },\n    {\n      \"contentType\": \"imageUrl\",\n      \"imageUrl\": \"https://example.com/image.jpg\",\n      \"mimeType\": \"image/jpeg\",\n      \"role\": \"user\"\n    }\n  ],\n  \"currentMessage\": \"Can you describe the colors in more detail?\"\n}",
    "responseModalities": ["TEXT"]
  }
  ```

  ## Advanced Configuration

  The node supports advanced parameters for fine-tuning:

  - **Temperature**: Controls creativity (0.0-1.0)
  - **Max Output Tokens**: Limits response length
  - **Top P**: Nucleus sampling parameter
  - **Top K**: Top-k sampling parameter
  - **Stream Response**: Enable real-time streaming

  ## Compatibility

  - **Minimum n8n version**: 0.227.0
  - **Node.js**: 20.15 or higher
  - **Tested with**: n8n 1.0+

  ### Known Limitations
  - Image generation requires sufficient API quotas
  - Large images may take longer to process
  - Rate limits apply based on your Google AI Studio plan

  ## Resources

  - [n8n community nodes documentation](https://docs.n8n.io/integrations/#community-nodes)
  - [Google AI Studio](https://makersuite.google.com/)
  - [Gemini API Documentation](https://ai.google.dev/gemini-api/docs)
  - [Google AI Studio API Key Management](https://makersuite.google.com/app/apikey)
  - [Node GitHub Repository](https://github.com/necto-pro/n8n-nodes-nano-banana)

  ## Contributing

  Contributions are welcome! Please feel free to submit a Pull Request.

  ### Development Setup

  1. Clone the repository:
     ```bash
     git clone https://github.com/necto-pro/n8n-nodes-nano-banana.git
     cd n8n-nodes-nano-banana
     ```

  2. Install dependencies:
     ```bash
     npm install
     ```

  3. Build the project:
     ```bash
     npm run build
     ```

  4. Lint the code:
     ```bash
     npm run lint
     npm run lintfix  # To auto-fix issues
     ```

  5. Test locally:
     ```bash
     npm run dev
     ```

  ## License

  [MIT](LICENSE.md)

  ---

  **Created by [Necto Pro](https://necto.pro)** | **Questions?** [Open an issue](https://github.com/necto-pro/n8n-nodes-nano-banana/issues)


node_type: n8n-nodes-convert-image.convertimage
package_name: n8n-nodes-convert-image
display_name: convertimage
category: Community
development_style: declarative
version: 0.0.2
properties_schema: []
operations: []
credentials_required: []
updated_at: 2026-04-16 09:43:37
author_name: mason276752
author_github_url: git+https://github.com/mason276752/n8n-nodes-convert-image.git
npm_package_name: n8n-nodes-convert-image
npm_version: 0.0.2
community_fetched_at: 2026-04-16T09:43:37.360Z
ai_summary_generated_at: 2026-03-25 22:47:20
description:
  n8n node for converting image formats between JPG, PNG, BMP, TIFF, etc. Supports both base64 and file inputs/outputs

npm_readme:
  ![Banner image](https://user-images.githubusercontent.com/10284570/173569848-c624317f-42b1-45a6-ab09-f0ea3c247648.png)

  # n8n-nodes-convert-image

  Custom n8n node for converting images to different formats (JPG, PNG, BMP, TIFF, GIF).  
  Handles both base64 and file inputs, outputs base64 or file data, and allows setting image quality.

  ## Features

  - Convert images between common formats  
  - Input as file or base64  
  - Output as file or base64  
  - Adjustable quality for JPG output  

  ## Prerequisites

  - n8n (version 1.0.0 or later)
  - Node.js 16 or newer

  ## Installation

  ```bash
  npm install n8n-nodes-convert-image
  ```

  ## Usage

  1. Provide the input file or base64 data.
  2. Select the target format and output type.
  3. For JPEG, define the desired quality (0-100).
  4. The node returns the converted image in the chosen format.

  ## Example

  1. Add the “Image Format Converter” node to your workflow.
  2. Pass your image as base64 or file data.
  3. Set the output format to “PNG”, for example.
  4. Define output as “file” or “base64”.
  5. The result will be a converted image in the desired format.

  ## License

  [MIT](LICENSE.md)

ai_documentation_summary:
  {"purpose":"Converts images between common formats (JPG, PNG, BMP, TIFF, GIF) supporting both file and base64 inputs/outputs with adjustable quality settings.","capabilities":["Convert images to JPG, PNG, BMP, TIFF, GIF formats","Accept file inputs","Accept base64 inputs","Output as file data","Output as base64 data","Adjust image quality for JPG output (0-100)"],"authentication":"None","commonUseCases":["Converting uploaded image files to web-friendly formats like JPG or PNG","Transforming base64-encoded images within workflow data","Batch processing image format conversions in automated workflows"],"limitations":["Requires n8n version 1.0.0 or later","Requires Node.js 16 or newer for installation","Quality adjustment is only available for JPG output"],"relatedNodes":["n8n-nodes-base.code","n8n-nodes-base.httpRequest"]}


node_type: n8n-nodes-browserless.browserless
package_name: n8n-nodes-browserless
display_name: browserless
description: n8n mode integrate with Browserless platform
category: Community
development_style: declarative
version: 1.1.3
properties_schema: []
operations: []
credentials_required: []
updated_at: 2026-04-16 09:43:37
author_name: minhlucvan
author_github_url: git+https://github.com/minhlucvan/n8n-nodes-browserless.git
npm_package_name: n8n-nodes-browserless
npm_version: 1.1.3
community_fetched_at: 2026-04-16T09:43:37.361Z
ai_summary_generated_at: 2026-03-25 22:47:20
npm_readme:
  # n8n-nodes-browserless

  <p align="center">
    <img src="https://user-images.githubusercontent.com/11575076/202373912-a90e5cc0-9dd2-4873-b782-6f86c78f00eb.png" />
  </p>

  #### New Updates: 🎉 **Browserless** API V2 is now supported.

  This is an n8n community node that allows you to interact with a [browserless](https://github.com/browserless/chrome) instance in your `n8n` workflows.

  **Browserless** is a web service that enables remote clients to connect, drive, and execute headless tasks, all within Docker. It provides first-class integrations for Puppeteer, Playwright, Selenium WebDriver, and several REST APIs for common tasks. Additionally, it addresses common issues like missing system fonts, external libraries, and performance improvements. It even handles tasks such as downloading files, managing sessions, and includes a fully-featured documentation site.

  If you’ve struggled with setting up Chrome in Docker or scaling headless workloads, browserless is designed for you.

  If you’ve been trying to automate browser-related tasks like `web scraping`, `browser automation`, `end-to-end testing`, or `PDF generation` with `n8n` and want to avoid dealing with browser infrastructure, the `n8n-nodes-browserless` will make your life easier.

  [n8n](https://n8n.io/) is a [fair-code licensed](https://docs.n8n.io/reference/license/) workflow automation platform.

  ## Table of Contents

  [Installation](#installation)  
  [Operations](#operations)  
  [Credentials](#credentials)  
  [Compatibility](#compatibility)  
  [Usage](#usage)  
  [Resources](#resources)  
  [Version history](#version-history)  

  ## Highlights

  - [x] Full control over Browserless
  - [x] Cloud compatibility
  - [x] Docker support by default
  - [x] Live browser debugging
  - [x] JavaScript injection
  - [x] Dynamic page rendering
  - [x] PDF download
  - [x] Screenshot capture
  - [x] Custom code execution

  ## Installation

  1. [Install Docker](https://docs.docker.com/engine/install/)
  2. [Install Browserless](https://docs.browserless.io/docs/docker-quickstart.html)

  ```shell
  $ docker run \
    --rm \
    -p 3000:3000 \
    -e "CONCURRENT=10" \
    -e "TOKEN=6R0W53R135510" \
    ghcr.io/browserless/chromium
  ```

  3. Visit your n8n instance > Settings > Community Nodes > Install `n8n-nodes-browserless`.
  4. Set up Browserless credentials with the URL `http://localhost:3000` and your secure token.
  5. Add the Browserless node to your workflow by searching for `browserless`.
  6. Start using Browserless in your n8n workflows!

  Follow the [installation guide](https://docs.n8n.io/integrations/community-nodes/installation/) in the n8n community nodes documentation.

  ## Operations

  - [Get page content](https://www.browserless.io/docs/content)
  - [Execute custom function](https://www.browserless.io/docs/function)
  - [Generate PDF of a page](https://www.browserless.io/docs/pdf)
  - [Capture page screenshot](https://www.browserless.io/docs/screenshot)
  - [Scrape page as JSON](https://www.browserless.io/docs/scrape)

  ## Credentials

  This node requires a Browserless `URL` and `token` to connect to your Browserless account or a self-hosted Browserless instance.

  ![](.//assets/credentials-setup.png)

  ## Compatibility

  This node was developed on `n8n@0.200.1`. It hasn't been tested on other versions yet.

  ## Usage

  1. Add the `browserless` node to your workflow.
     ![](./assets/browserless-node.png)
  2. Configure your node.
     ![](./assets/browserless-content.png)
     ![](./assets/browserless-screenshot.png)
     ![image](https://user-images.githubusercontent.com/11575076/202370828-c8e3896e-1fc5-4f08-b147-688e55c90c74.png)

  ## Anti-Bot Detection

  With strong support from Browserless, you can implement robust anti-bot detection using the following setup:

  - `Browser Options` > `Stealth` On
  - `Browser Options` > `Headless` Off

  ![](./assets/anti-bot-detector.png)

  ## Resources

  * [n8n Community Nodes Documentation](https://docs.n8n.io/integrations/community-nodes/)
  * [Browserless Homepage](https://www.browserless.io/)
  * [Browserless API Documentation](https://www.browserless.io/docs/api)
  * [Browserless Self-Hosted Quick Start](https://www.browserless.io/docs/docker-quickstart)

  ## Version History

  - `0.0.1` Initial release
  - `0.2.0` Fixed common issues
  - `0.3.0` Fixed [#1](https://github.com/minhlucvan/n8n-nodes-browserless/issues/1), added tests
  - `0.4.0` Added browser options, set no-cache as the default header
  - `0.5.0` Implemented anti-bot detection
  - `1.0.0` Added support for `browserless` API v2

ai_documentation_summary:
  {"purpose":"This n8n community node enables interaction with a Browserless instance to perform headless browser tasks without managing local browser infrastructure.","capabilities":["Web scraping as JSON","PDF generation","Screenshot capture","Custom JavaScript execution","Page content retrieval","Live browser debugging","Dynamic page rendering","File downloading","Session management","Anti-bot detection via stealth mode"],"authentication":"API token required (Browserless token)","commonUseCases":["Web scraping automation","End-to-end testing","PDF generation from web pages","Browser automation workflows","Anti-bot detection implementation"],"limitations":["Developed and tested on n8n@0.200.1 only; compatibility with other versions not verified","Requires Docker installation and a running Browserless instance"],"relatedNodes":["n8n HTTP Request","n8n Code","n8n PDF","n8n Screenshot"]}


node_type: n8n-nodes-asaas-pagamentos.asaaspagamentos
package_name: n8n-nodes-asaas-pagamentos
display_name: asaaspagamentos
description: Node n8n para integração da plataforma de pagamento Asaas
category: Community
development_style: declarative
version: 0.1.2
properties_schema: []
operations: []
credentials_required: []
updated_at: 2026-04-16 09:43:37
author_name: 99lab.dev
author_github_url: git+https://github.com/99labdev/n8n-nodes-asaas.git
npm_package_name: n8n-nodes-asaas-pagamentos
npm_version: 0.1.2
community_fetched_at: 2026-04-16T09:43:37.362Z
ai_summary_generated_at: 2026-03-25 22:47:20
npm_readme:
  # n8n-nodes-asaas-pagamentos

  ![Asaas Logo](logo.png)

  Este é um nó da comunidade n8n. Ele permite que você use o Asaas em seus fluxos de trabalho n8n.

  O Asaas é uma plataforma de pagamentos brasileira que oferece soluções completas para cobrança, recebimento e pagamento, incluindo PIX, boleto bancário, cartão de crédito e débito, TED, além de funcionalidades como gestão de assinaturas, split de pagamentos, antecipação de recebíveis e muito mais.

  [n8n](https://n8n.io/) é uma plataforma de automação de fluxo de trabalho [licenciada fair-code](https://docs.n8n.io/reference/license/).

  ## Instalação

  Siga o [guia de instalação](https://docs.n8n.io/integrations/community-nodes/installation/) na documentação de nós da comunidade n8n.

  ```bash
  npm install n8n-nodes-asaas-pagamentos
  ```

  ## Operações

  ### Recursos Implementados da API Asaas

  #### ✅ Clientes

  - [x] **Listar clientes** - Recuperar lista de clientes com filtros opcionais
  - [x] **Criar novo cliente** - Criar um novo cliente com dados pessoais, de contato e endereço
  - [x] **Recuperar cliente específico** - Obter detalhes completos de um cliente pelo ID
  - [x] **Atualizar cliente existente** - Modificar dados de um cliente já cadastrado
  - [x] **Deletar cliente** - Remover cliente do sistema permanentemente
  - [x] **Restaurar cliente removido** - Reativar cliente que foi deletado anteriormente

  #### ⏳ Cobranças (Payments)

  - [ ] **Criar nova cobrança** - Criar cobrança com diversas formas de pagamento
  - [ ] **Listar cobranças** - Recuperar lista de cobranças com filtros avançados
  - [ ] **Criar cobrança com cartão de crédito** - Cobrança direta com cartão
  - [ ] **Capturar cobrança com Pré-Autorização** - Finalizar pagamento pré-autorizado
  - [ ] **Pagar cobrança com cartão de crédito** - Processar pagamento de cobrança existente
  - [ ] **Recuperar informações de pagamento** - Obter dados de billing de uma cobrança
  - [ ] **Informações sobre visualização** - Dados de quando a cobrança foi visualizada
  - [ ] **Recuperar cobrança específica** - Obter detalhes de uma cobrança
  - [ ] **Atualizar cobrança existente** - Modificar dados de cobrança pendente
  - [ ] **Excluir cobrança** - Remover cobrança do sistema
  - [ ] **Restaurar cobrança removida** - Reativar cobrança excluída
  - [ ] **Recuperar status de cobrança** - Verificar status atual da cobrança
  - [ ] **Estornar cobrança** - Realizar estorno total ou parcial
  - [ ] **Obter linha digitável do boleto** - Código de barras para pagamento
  - [ ] **Obter QR Code PIX** - Gerar QR Code para pagamento via PIX
  - [ ] **Confirmar recebimento em dinheiro** - Marcar como pago em dinheiro
  - [ ] **Desfazer confirmação em dinheiro** - Cancelar confirmação de pagamento em dinheiro
  - [ ] **Simulador de vendas** - Simular cenários de pagamento

  #### ⏳ Ações em Sandbox

  - [ ] **Confirmar pagamento** - Simular confirmação de pagamento no ambiente de teste
  - [ ] **Adicionar saldo** - Adicionar crédito para testes na conta sandbox

  #### ⏳ Cobranças com Dados Resumidos

  - [ ] **Criar cobrança com dados resumidos** - Retorna resposta simplificada para performance

  #### ⏳ Cartão de Crédito

  - [ ] **Tokenização de cartão de crédito** - Gerar token seguro para cartão
  - [ ] **Criar cobrança com cartão tokenizado** - Usar token para criar cobrança
  - [ ] **Validar dados do cartão** - Verificar se cartão é válido
  - [ ] **Listar cartões tokenizados** - Recuperar cartões salvos do cliente

  #### ⏳ Estornos

  - [ ] **Listar estornos de uma cobrança** - Histórico de estornos
  - [ ] **Criar estorno total** - Estornar valor completo da cobrança
  - [ ] **Criar estorno parcial** - Estornar parte do valor da cobrança
  - [ ] **Recuperar detalhes do estorno** - Informações específicas do estorno

  #### ⏳ Splits de Pagamento

  - [ ] **Recuperar split pago** - Informações de divisão de pagamento realizada
  - [ ] **Configurar splits** - Definir divisão de valores entre contas
  - [ ] **Listar splits** - Histórico de divisões de pagamento
  - [ ] **Cancelar split** - Desfazer divisão configurada

  #### ⏳ Conta Escrow

  - [ ] **Encerrar garantia da cobrança** - Finalizar processo de garantia
  - [ ] **Configurar conta escrow** - Ativar sistema de garantia
  - [ ] **Consultar status escrow** - Verificar situação da garantia

  #### ⏳ Documentos de Cobranças

  - [ ] **Upload de documentos da cobrança** - Anexar arquivos à cobrança
  - [ ] **Listar documentos** - Recuperar arquivos anexados
  - [ ] **Deletar documento** - Remover arquivo anexado
  - [ ] **Download de documento** - Baixar arquivo específico

  #### ⏳ Notificações

  - [ ] **Atualizar notificação existente** - Modificar configurações de notificação
  - [ ] **Configurar notificações** - Definir tipos de notificações ativas
  - [ ] **Listar notificações** - Recuperar histórico de notificações enviadas
  - [ ] **Criar nova notificação** - Configurar nova regra de notificação
  - [ ] **Deletar notificação** - Remover configuração de notificação

  #### ⏳ Parcelamentos

  - [ ] **Criar parcelamento** - Dividir cobrança em múltiplas parcelas
  - [ ] **Listar parcelamentos** - Recuperar parcelamentos criados
  - [ ] **Recuperar parcelamento específico** - Detalhes de um parcelamento
  - [ ] **Atualizar parcelamento** - Modificar parcelamento existente
  - [ ] **Deletar parcelamento** - Cancelar parcelamento

  #### ⏳ Assinaturas (Recorrência)

  - [ ] **Criar nova assinatura** - Configurar cobrança recorrente
  - [ ] **Listar assinaturas** - Recuperar assinaturas ativas e inativas
  - [ ] **Recuperar assinatura específica** - Detalhes de uma assinatura
  - [ ] **Atualizar assinatura** - Modificar dados da assinatura
  - [ ] **Cancelar assinatura** - Encerrar cobrança recorrente
  - [ ] **Listar cobranças da assinatura** - Histórico de cobranças geradas
  - [ ] **Listar faturas da assinatura** - Faturas relacionadas à assinatura

  #### ⏳ PIX

  - [ ] **Criar chave PIX** - Registrar nova chave PIX na conta
  - [ ] **Listar chaves PIX** - Recuperar chaves PIX cadastradas
  - [ ] **Deletar chave PIX** - Remover chave PIX da conta
  - [ ] **Criar cobrança PIX** - Gerar cobrança específica para PIX
  - [ ] **Gerar QR Code estático** - QR Code reutilizável para recebimentos
  - [ ] **Gerar QR Code dinâmico** - QR Code para valor específico
  - [ ] **Decodificar QR Code** - Extrair informações de QR Code PIX

  #### ⏳ Transações PIX

  - [ ] **Pagar QR Code** - Efetuar pagamento via QR Code PIX
  - [ ] **Listar transações PIX** - Histórico de transações PIX
  - [ ] **Cancelar transação PIX** - Estornar transação PIX quando possível
  - [ ] **Recuperar comprovante PIX** - Obter comprovante da transação
  - [ ] **Consultar status transação** - Verificar situação da transação PIX

  #### ⏳ PIX Recorrente

  - [ ] **Listar recorrências PIX** - Recuperar PIX programados
  - [ ] **Criar recorrência PIX** - Agendar PIX recorrente
  - [ ] **Cancelar recorrência PIX** - Interromper PIX programado
  - [ ] **Atualizar recorrência PIX** - Modificar agendamento PIX

  #### ⏳ Link de Pagamentos

  - [ ] **Criar link de pagamentos** - Gerar link para recebimento online
  - [ ] **Listar links de pagamentos** - Recuperar links criados
  - [ ] **Atualizar link de pagamentos** - Modificar configurações do link
  - [ ] **Recuperar link específico** - Detalhes de um link de pagamento
  - [ ] **Deletar link de pagamentos** - Remover link criado
  - [ ] **Recuperar QR Code do link** - QR Code para compartilhamento

  #### ⏳ Checkout

  - [ ] **Criar novo checkout** - Página de checkout personalizada
  - [ ] **Configurar checkout** - Definir aparência e comportamento
  - [ ] **Recuperar configurações** - Obter configurações do checkout
  - [ ] **Atualizar configurações** - Modificar checkout existente

  #### ⏳ Transferências

  - [ ] **Transferir para conta de outra instituição** - TED/DOC para outros bancos
  - [ ] **Transferir via chave PIX** - Transferência instantânea via PIX
  - [ ] **Listar transferências** - Histórico de transferências realizadas
  - [ ] **Recuperar transferência específica** - Detalhes de uma transferência
  - [ ] **Cancelar transferência** - Cancelar transferência agendada
  - [ ] **Transferir para conta Asaas** - Transferência entre contas Asaas

  #### ⏳ Antecipações

  - [ ] **Recuperar antecipação** - Informações sobre antecipação específica
  - [ ] **Solicitar antecipação** - Antecipar recebíveis disponíveis
  - [ ] **Listar antecipações** - Histórico de antecipações
  - [ ] **Simular antecipação** - Calcular valores de antecipação
  - [ ] **Cancelar antecipação** - Cancelar solicitação pendente

  #### ⏳ Negativações

  - [ ] **Criar negativação** - Registrar negativação de cliente
  - [ ] **Listar negativações** - Recuperar negativações realizadas
  - [ ] **Recuperar negativação específica** - Detalhes de uma negativação
  - [ ] **Cancelar negativação** - Remover negativação ativa
  - [ ] **Consultar situação CPF/CNPJ** - Verificar restrições existentes

  #### ⏳ Pagamento de Contas

  - [ ] **Criar pagamento de conta** - Pagar boletos e contas
  - [ ] **Listar pagamentos de contas** - Histórico de pagamentos
  - [ ] **Recuperar pagamento específico** - Detalhes de um pagamento
  - [ ] **Cancelar pagamento** - Cancelar pagamento agendado
  - [ ] **Consultar código de barras** - Verificar dados do boleto
  - [ ] **Simular pagamento** - Calcular taxas e prazos

  #### ⏳ Recargas de Celular

  - [ ] **Solicitar recarga** - Fazer recarga de celular pré-pago
  - [ ] **Listar recargas** - Histórico de recargas realizadas
  - [ ] **Recuperar recarga específica** - Detalhes de uma recarga
  - [ ] **Consultar operadoras** - Listar operadoras disponíveis
  - [ ] **Consultar valores** - Valores de recarga disponíveis

  #### ⏳ Consulta Serasa

  - [ ] **Realizar consulta Serasa** - Consultar CPF/CNPJ no Serasa
  - [ ] **Listar consultas** - Histórico de consultas realizadas
  - [ ] **Recuperar consulta específica** - Resultado de uma consulta
  - [ ] **Consultar score** - Verificar score de crédito

  #### ⏳ Extrato

  - [ ] **Recuperar extrato** - Extrato financeiro da conta
  - [ ] **Filtrar por período** - Extrato de período específico
  - [ ] **Exportar extrato** - Download do extrato em PDF/Excel
  - [ ] **Extrato detalhado** - Informações completas das transações

  #### ⏳ Informações Financeiras

  - [ ] **Recuperar saldo da conta** - Saldo atual e disponível
  - [ ] **Obter informações financeiras** - Dados financeiros consolidados
  - [ ] **Estatísticas de faturamento** - Métricas de recebimento
  - [ ] **Previsão de recebimentos** - Valores a receber por período

  #### ⏳ Informações da Conta

  - [ ] **Recuperar dados comerciais** - Informações da empresa
  - [ ] **Atualizar informações da conta** - Modificar dados cadastrais
  - [ ] **Configurar personalização** - White label e customizações
  - [ ] **Recuperar configurações** - Configurações atuais da conta
  - [ ] **Upload de logo** - Personalizar logotipo da conta

  #### ⏳ Notas Fiscais

  - [ ] **Agendar nota fiscal** - Programar emissão de NF
  - [ ] **Listar notas fiscais** - Histórico de notas emitidas
  - [ ] **Recuperar nota específica** - Detalhes de uma nota fiscal
  - [ ] **Cancelar nota fiscal** - Cancelar nota já emitida
  - [ ] **Download de XML** - Baixar arquivo XML da nota
  - [ ] **Enviar por email** - Enviar nota fiscal por email

  #### ⏳ Informações Fiscais

  - [ ] **Listar configurações municipais** - Configurações fiscais por cidade
  - [ ] **Configurar informações fiscais** - Definir dados para emissão de NF
  - [ ] **Atualizar configurações** - Modificar configurações fiscais
  - [ ] **Consultar alíquotas** - Verificar alíquotas municipais

  #### ⏳ Webhooks

  - [ ] **Criar novo webhook** - Configurar notificação via HTTP
  - [ ] **Listar webhooks** - Recuperar webhooks configurados
  - [ ] **Atualizar webhook** - Modificar configurações de webhook
  - [ ] **Deletar webhook** - Remover webhook configurado
  - [ ] **Testar webhook** - Enviar evento de teste
  - [ ] **Reenviar evento** - Reprocessar evento específico
  - [ ] **Listar eventos** - Histórico de eventos enviados

  #### ⏳ Subcontas

  - [ ] **Criar subconta** - Criar conta filha
  - [ ] **Listar subcontas** - Recuperar subcontas criadas
  - [ ] **Configurar subconta** - Definir permissões e limites
  - [ ] **Atualizar subconta** - Modificar configurações
  - [ ] **Desativar subconta** - Suspender acesso da subconta
  - [ ] **Transferir entre subcontas** - Movimentar valores

  #### ⏳ Documentos White Label

  - [ ] **Verificar documentos pendentes** - Documentos aguardando aprovação
  - [ ] **Enviar documentos** - Upload de documentos para análise
  - [ ] **Consultar status** - Situação da análise de documentos
  - [ ] **Reenviar documentos** - Submeter novamente após rejeição

  #### ⏳ Chargeback

  - [ ] **Criar disputa de chargeback** - Contestar chargeback recebido
  - [ ] **Listar chargebacks** - Histórico de chargebacks
  - [ ] **Recuperar chargeback específico** - Detalhes de uma disputa
  - [ ] **Anexar documentos** - Adicionar evidências à disputa
  - [ ] **Acompanhar processo** - Status da contestação

  #### ⏳ Cidades e Localização

  - [ ] **Listar estados** - Estados brasileiros disponíveis
  - [ ] **Listar cidades por estado** - Cidades de um estado específico
  - [ ] **Consultar CEP** - Buscar endereço por CEP
  - [ ] **Validar endereço** - Verificar validade de endereço

  #### ⏳ Relatórios e Analytics

  - [ ] **Relatório de vendas** - Análise de faturamento por período
  - [ ] **Relatório de inadimplência** - Cobranças em atraso
  - [ ] **Métricas de conversão** - Taxa de conversão de pagamentos
  - [ ] **Dashboard financeiro** - Visão geral dos indicadores

  ## Credenciais

  Para usar este nó, você precisa se autenticar com o Asaas. Você deve incluir os pré-requisitos (como criar uma conta no serviço), métodos de autenticação disponíveis e como configurá-los.

  ### Pré-requisitos

  1. Crie uma conta no [Asaas](https://asaas.com) ou no [Sandbox do Asaas](https://sandbox.asaas.com) para testes
  2. Gere sua chave de API no painel do Asaas

  ### Configuração de Autenticação

  1. No n8n, vá para **Credenciais** > **Criar Nova Credencial**
  2. Selecione **Asaas API**
  3. Configure os seguintes campos:
     - **Chave de API**: Sua chave de API do Asaas
     - **Ambiente**: Escolha entre Produção ou Sandbox
  4. Teste a conexão e salve

  ## Compatibilidade

  - **Versão mínima do n8n**: 1.0.0
  - **Versões testadas**: 1.0.0+
  - **Node.js**: >=20.15

  ## Uso

  Este nó permite integrar facilmente o Asaas aos seus fluxos de trabalho n8n. Comece criando clientes e depois avance para criação de cobranças e outras operações conforme suas necessidades.

  Para usuários iniciantes no n8n, consulte a documentação [Experimente](https://docs.n8n.io/try-it-out/) para começar.

  ## Recursos

  - [Documentação dos nós da comunidade n8n](https://docs.n8n.io/integrations/#community-nodes)
  - [Documentação da API do Asaas](https://docs.asaas.com/docs)
  - [Referência da API do Asaas](https://docs.asaas.com/reference)
  - [Portal de desenvolvedores Asaas](https://asaas.com/developers)
  - [Comunidade Discord Asaas](https://discord.gg/invite/X2kgZm69HV)

  ## Licença

  [MIT](LICENSE.md)

ai_documentation_summary:
  {"purpose":"A community n8n node for integrating with the Asaas Brazilian payment platform to manage customers, payments, subscriptions, and other financial operations.","capabilities":["List and create customers","Retrieve, update, and delete customers","Create and manage payments (invoices)","Process credit card payments","Generate QR Code for PIX","Manage recurring subscriptions","Handle payment splits","Manage escrow accounts","Upload and manage invoice documents","Configure notifications"],"authentication":"API key required (implied by standard Asaas integration pattern, not explicitly detailed in README)","commonUseCases":["Automating invoice creation and payment collection","Managing customer billing cycles","Processing recurring subscription payments","Splitting payments among multiple recipients","Handling PIX and credit card transactions"],"limitations":["Many payment-related operations are not yet implemented (indicated by unchecked checkboxes in README)","Documentation is incomplete (README truncated)"],"relatedNodes":["n8n-nodes-base.httpRequest","n8n-nodes-base.code"]}


node_type: n8n-nodes-waha.waha
package_name: n8n-nodes-waha
display_name: waha
description: n8n to connect with WAHA (Whatsapp HTTP API)
category: Community
development_style: declarative
version: 2024.11.5
properties_schema: []
operations: []
credentials_required: []
updated_at: 2026-04-16 09:43:37
author_name: morning-bird
author_github_url: git+https://github.com/devlikeapro/n8n-nodes-waha.git
npm_package_name: n8n-nodes-waha
npm_version: 2024.11.5
community_fetched_at: 2026-04-16T09:43:37.363Z
ai_summary_generated_at: 2026-03-25 22:47:20
npm_readme:
  # @devlikeapro/n8n-nodes-waha
  <p align="center">
    <img src="https://github.com/devlikeapro/n8n-nodes-waha/blob/master/WAHA+n8n.png?raw=true" width='300'/>
  </p>

  This is a n8n community node. 
  It lets you use [WAHA - WhatsApp HTTP API](https://waha.devlike.pro) in your n8n workflows.

  - [**WAHA**](https://waha.devlike.pro) - **WhatsApp API** that you can run in a click!
  - [n8n](https://n8n.io/) is a [fair-code licensed](https://docs.n8n.io/reference/license/) workflow automation platform.

  👉 Generated from
  [**WAHA OpenAPI**](https://waha.devlike.pro/swagger/)
  using [**devlikeapro/n8n-openapi-node**](https://github.com/devlikeapro/n8n-openapi-node)

  ![NPM Version](https://img.shields.io/npm/v/%40devlikeapro%2Fn8n-nodes-waha)

  <!-- toc -->

  - [Install WAHA n8n node](#install-waha-n8n-node)
  - [Links](#links)
  - [Workflow Examples](#workflow-examples)

  <!-- tocstop -->

  ![WAHA Workflow Example Screenshot](./waha-n8n-workflow-example.png)

  ## Install WAHA n8n node
  Go to your **n8n** => **Settings** => **Community nodes** and install:

  ```
  @devlikeapro/n8n-nodes-waha
  ```

  If you need help with that, check the
  [**Install community nodes**](https://docs.n8n.io/integrations/community-nodes/installation/gui-install/)

  ## Links
  - [**WAHA + n8n: No Code Low Code WhatsApp Automation Step-By-Step Guide**](https://waha/devlike.pro/blog/waha-n8n/)
  - [**🧩 WAHA + n8n Integration**](https://waha.devlike.pro/docs/integrations/n8n/)
  - [**WAHA n8n Workflow Templates**](http://waha-n8n-templates.devlike.pro/)

  ## Workflow Examples
  👉 Check out [**n8n-workflows**](http://waha-n8n-templates.devlike.pro/) folder for examples.

ai_documentation_summary:
  {"purpose":"Connects n8n workflows with WAHA (WhatsApp HTTP API) to automate WhatsApp messaging and interactions.","capabilities":["Send WhatsApp messages","Receive WhatsApp messages","Manage WhatsApp contacts","Create and manage WhatsApp groups","Automate WhatsApp business operations"],"authentication":"API key required (via WAHA credentials)","commonUseCases":["Automated customer support responses","Order status notifications","Appointment reminders","Marketing campaigns"],"limitations":["Requires WAHA account setup","Limited to WhatsApp Business API features supported by WAHA"],"relatedNodes":["n8n-nodes-waha.waha","n8n-nodes-openapi-node"]}


node_type: @inite/n8n-nodes-instagram-private-api.instagramprivateapi
package_name: @inite/n8n-nodes-instagram-private-api
display_name: instagramprivateapi
description: n8n node for Instagram Private API with 2FA support
category: Community
development_style: declarative
version: 1.0.43
properties_schema: []
operations: []
credentials_required: []
updated_at: 2026-04-16 09:43:37
author_name: mikefluff
author_github_url: git+https://github.com/inite-ai/n8n-nodes-instagram-private-api.git
npm_package_name: @inite/n8n-nodes-instagram-private-api
npm_version: 1.0.43
community_fetched_at: 2026-04-16T09:43:37.364Z
npm_readme:
  ��# n8n-nodes-instagram-private-api
  
  
  
  This is an n8n community node for interacting with Instagram using the Instagram Private API. It provides comprehensive functionality for posting content, managing direct messages, handling comments, and monitoring Instagram activities.
  
  
  
  [n8n](https://n8n.io/) is a [fair-code licensed](https://docs.n8n.io/reference/license/) workflow automation platform.
  
  
  
  [Installation](#installation)  
  
  [Setup](#setup)  
  
  [Operations](#operations)  
  
  [Triggers](#triggers)  
  
  [Examples](#examples)  
  
  [Resources](#resources)  
  
  [Version history](#version-history)
  
  
  
  ## Installation
  
  
  
  Follow these steps to install the node:
  
  
  
  1. Open your n8n instance
  
  2. Go to **Settings** > **Community Nodes**
  
  3. Select **Install**
  
  4. Enter `@inite/n8n-nodes-instagram-private-api`
  
  5. Click **Install**
  
  
  
  Alternatively, you can install it using npm:
  
  
  
  ```bash
  
  npm install @inite/n8n-nodes-instagram-private-api
  
  ```
  
  
  
  ## Setup
  
  
  
  1. Create new credentials in n8n:
  
  
  
     - Go to **Credentials** > **New**
  
     - Search for "Instagram Private API"
  
     - Enter your Instagram username and password
  
  
  
  2. Important Security Notes:
  
     - Store your credentials securely
  
     - Use a dedicated Instagram account for automation
  
     - Follow Instagram's rate limits and usage guidelines
  
     - Consider using Instagram's official API for business accounts
  
  
  
  ## Features
  
  
  
  - Full Instagram Private API support
  
  - Two-Factor Authentication (2FA) support
  
  - Session storage for faster subsequent logins
  
  - Proxy support for enhanced security
  
  - Comprehensive error handling
  
  
  
  ## Operations
  
  
  
  ### Instagram Private API Node
  
  
  
  #### Content Publishing
  
  
  
  - **Post**: Post images or videos to your feed
  
  
  
    ```json
  
    {
  
      "operation": "post",
  
      "contentType": "image",
  
      "media": "https://example.com/image.jpg",
  
      "caption": "My awesome post!"
  
    }
  
    ```
  
  
  
  - **Post Story**: Share stories
  
  
  
    ```json
  
    {
  
      "operation": "postStory",
  
      "contentType": "video",
  
      "media": "https://example.com/video.mp4",
  
      "coverImage": "https://example.com/cover.jpg"
  
    }
  
    ```
  
  
  
  - **Post Reel**: Create engaging reels
  
    ```json
  
    {
  
      "operation": "postReel",
  
      "media": "https://example.com/reel.mp4",
  
      "caption": "Check out my new reel!",
  
      "coverImage": "https://example.com/cover.jpg"
  
    }
  
    ```
  
  
  
  #### Engagement
  
  
  
  - **Comment**: Interact with posts
  
  
  
    ```json
  
    {
  
      "operation": "comment",
  
      "mediaId": "12345",
  
      "commentText": "Great post!"
  
    }
  
    ```
  
  
  
  - **Send DM**: Message users directly
  
    ```json
  
    {
  
      "operation": "sendDM",
  
      "userId": "67890",
  
      "messageText": "Hello there!"
  
    }
  
    ```
  
  
  
  #### Information Retrieval
  
  
  
  - **Get User Info**: Fetch user details
  
  - **Get User Feed**: Access user's posts
  
  - **Get User Stories**: View user's stories
  
  
  
  ## Triggers
  
  
  
  ### Instagram Trigger Node
  
  
  
  Monitor Instagram activities in real-time:
  
  
  
  #### New DM Trigger
  
  
  
  ```json
  
  {
  
    "event": "newDM",
  
    "pollInterval": 60,
  
    "output": {
  
      "threadId": "123",
  
      "userId": "456",
  
      "username": "user",
  
      "message": "Hello!",
  
      "timestamp": 1234567890
  
    }
  
  }
  
  ```
  
  
  
  #### New Comment Trigger
  
  
  
  ```json
  
  {
  
    "event": "newComment",
  
    "pollInterval": 60,
  
    "output": {
  
      "mediaId": "789",
  
      "userId": "012",
  
      "username": "commenter",
  
      "text": "Nice!",
  
      "timestamp": 1234567890
  
    }
  
  }
  
  ```
  
  
  
  ## Examples
  
  
  
  ### Automated Story Sharing
  
  
  
  ```javascript
  
  // When a new image is uploaded to cloud storage
  
  // Post it as an Instagram story
  
  {
  
    "operation": "postStory",
  
    "contentType": "image",
  
    "media": "{{$node.trigger.json.imageUrl}}"
  
  }
  
  ```
  
  
  
  ### Comment Monitoring and Response
  
  
  
  ```javascript
  
  // When a new comment is received
  
  // Send a thank you DM to the commenter
  
  {
  
    "operation": "sendDM",
  
    "userId": "{{$node.instagramTrigger.json.userId}}",
  
    "messageText": "Thanks for your comment!"
  
  }
  
  ```
  
  
  
  ## Resources
  
  
  
  - [n8n Community Nodes Documentation](https://docs.n8n.io/integrations/community-nodes/)
  
  - [Instagram Private API Documentation](https://github.com/dilame/instagram-private-api)
  
  - [Instagram Rate Limits](https://developers.facebook.com/docs/instagram-api/reference/rate-limits)
  
  - [Best Practices for Instagram Automation](https://developers.facebook.com/docs/instagram-api/guides/content-publishing)
  
  
  
  ## Version history
  
  
  
  ### 1.0.0 (2024-04-07)
  
  
  
  - Initial release with comprehensive Instagram functionality
  
  - Content publishing (posts, stories, reels)
  
  - Direct messaging and commenting capabilities
  
  - User information and feed retrieval
  
  - Real-time triggers for DMs and comments
  
  - Extensive error handling and rate limit management
  
  
  
  ## License
  
  
  
  [MIT](LICENSE.md)
  
  


node_type: n8n-nodes-wuzapi.wuzapi
package_name: n8n-nodes-wuzapi
display_name: wuzapi
description: n8n community nodes for Wuzapi - WhatsApp Multi-Device REST API
category: Community
development_style: declarative
version: 1.6.0
properties_schema: []
operations: []
credentials_required: []
updated_at: 2026-04-16 09:43:37
author_name: guilhermejansenoficial
author_github_url: git+https://github.com/guilhermejansen/n8n-nodes-wuzapi.git
npm_package_name: n8n-nodes-wuzapi
npm_version: 1.6.0
community_fetched_at: 2026-04-16T09:43:37.365Z
ai_summary_generated_at: 2026-03-25 22:47:20
npm_readme:
  # n8n-nodes-wuzapi

  This is an n8n community node that provides a complete integration with [Wuzapi](https://github.com/asternic/wuzapi) - a multi-user and multi-device REST API for WhatsApp.

  Wuzapi implements a robust WhatsApp Web API that allows you to send and receive messages, manage groups, handle media files, and much more through a simple REST interface.

  [n8n](https://n8n.io/) is a [fair-code licensed](https://docs.n8n.io/reference/license/) workflow automation platform.

  ## Table of Contents

  - [Installation](#installation)
  - [Operations](#operations)
  - [Credentials](#credentials)
  - [Nodes Overview](#nodes-overview)
  - [Usage Examples](#usage-examples)
  - [Features](#features)
  - [Error Handling](#error-handling)
  - [Compatibility](#compatibility)
  - [Resources](#resources)

  ## Installation

  Follow the [installation guide](https://docs.n8n.io/integrations/community-nodes/installation/) in the n8n community nodes documentation.

  ### Quick Installation

  1. In n8n, go to **Settings** > **Community Nodes**
  2. Click **Install a community node**
  3. Enter `n8n-nodes-wuzapi`
  4. Click **Install**

  ### Manual Installation

  ```bash
  npm install n8n-nodes-wuzapi
  ```

  ## Operations

  This package includes 11 specialized nodes, each focused on specific WhatsApp operations:

  ### 🔐 Wuzapi Credentials
  Handles authentication with your Wuzapi instance.

  ### 📱 Wuzapi Session
  - **Connect** - Connect to WhatsApp servers
  - **Disconnect** - Disconnect from WhatsApp
  - **Get Status** - Check connection status
  - **Get QR Code** - Get QR code for scanning
  - **Logout** - Logout and terminate session
  - **Pair Phone** - Get pairing code for phone
  - **Set Proxy** - Configure proxy settings
  - **Configure S3** - Set up S3 storage for media
  - **Test S3** - Test S3 connection

  ### 💬 Wuzapi Message
  Send various types of messages:
  - **Text** - Send text messages
  - **Image** - Send images with optional captions
  - **Audio** - Send audio messages
  - **Video** - Send videos with optional captions
  - **Document** - Send documents of any type
  - **Sticker** - Send stickers
  - **Location** - Send location coordinates
  - **Contact** - Send contact cards (vCard)
  - **Template** - Send template messages with buttons
  - **Buttons** - Send interactive button messages
  - **List** - Send list messages
  - **Poll** - Send polls to groups

  ### 🗨️ Wuzapi Chat
  Manage chat interactions:
  - **Delete Message** - Delete sent messages
  - **Edit Message** - Edit previously sent messages
  - **Download Media** - Download media from messages
  - **Mark as Read** - Mark messages as read
  - **React to Message** - Send reactions to messages
  - **Set Presence** - Show typing/recording indicators

  ### 👤 Wuzapi User
  User information and presence:
  - **Check Users** - Check if users have WhatsApp
  - **Get User Info** - Get detailed user information
  - **Get Avatar** - Get user profile pictures
  - **Get Contacts** - Get all contacts
  - **Set Presence** - Set global online/offline status

  ### 👥 Wuzapi Group
  Complete group management:
  - **Create** - Create new groups
  - **List** - List all groups
  - **Get Info** - Get group information
  - **Get Invite Link** - Get group invite link
  - **Join** - Join group via invite
  - **Leave** - Leave a group
  - **Set Name** - Change group name
  - **Set Description** - Set group description
  - **Set Photo** - Set group photo
  - **Remove Photo** - Remove group photo
  - **Set Announce** - Enable/disable admin-only messages
  - **Set Locked** - Lock/unlock group info editing
  - **Set Ephemeral** - Configure disappearing messages
  - **Update Participants** - Add/remove/promote/demote members

  ### 🔗 Wuzapi Webhook
  Configure webhook settings:
  - **Get** - Get current webhook configuration
  - **Set** - Configure webhook URL and events
  - **Update** - Update webhook settings
  - **Delete** - Remove webhook configuration

  ### 👨‍💼 Wuzapi Admin
  Administrative operations (requires admin token):
  - **List Users** - List all Wuzapi users
  - **Create User** - Create new user with token
  - **Delete User** - Delete user from database
  - **Delete User Full** - Complete user removal (DB, S3, logout)

  ### 🔔 Wuzapi Trigger
  Receive real-time WhatsApp events with complete event mapping:
  - **Events** - Message, Read Receipt, Presence, History Sync, Chat Presence, All Events
  - **Advanced Filters** - Filter by sender phone, chat ID, message type, content, groups/direct, from me/others, token
  - **Message Type Detection** - Automatic detection of text, media, PTT, documents, stickers, URLs, locations, contacts, buttons, lists, templates, polls, orders, and unknown types
  - **Media Support** - Complete base64 and S3 media data extraction
  - **Content Parsing** - Intelligent message content extraction with type-specific fields
  - **Simplified Output** - Clean, structured output with all relevant fields mapped
  - **Raw Data Access** - Optional complete raw webhook data for debugging

  ### ⏳ Wuzapi Send and Wait
  Send messages and wait for responses:
  - **Approval Messages** - Send messages with approval buttons
  - **Free Text Response** - Wait for user text input via web form
  - **Custom Forms** - Create custom forms for user responses
  - **Wait Time Limits** - Set maximum wait times
  - **Attribution** - Optional n8n branding

  ### 🤖 Wuzapi AI
  Optimized for AI workflows and tools with complete message type support:
  - **Send Text** - Send text messages with AI-friendly interface
  - **Send Image** - Send images with captions (Binary/Base64/URL)
  - **Send Audio** - Send audio messages with PTT support (Binary/Base64/URL)
  - **Send Video** - Send videos with captions (Binary/Base64/URL)
  - **Send Document** - Send documents with filenames (Binary/Base64/URL)
  - **Send Location** - Send geographical coordinates with location names
  - **Send Contact** - Send contact information with VCard data
  - **Send Sticker** - Send stickers in WebP format (Binary/Base64/URL)
  - **Send Buttons** - Send interactive button messages for AI decision trees
  - **Send List** - Send structured lists with multiple options for AI menus
  - **Send Poll** - Send group polls for AI-driven surveys and decisions
  - **Universal Media Support** - All media types support Binary Data, Base64, and URL sources
  - **Mention System** - Complete mention support for specific users and all group members
  - **Batch Processing** - Process multiple recipients and message types efficiently
  - **Error Tolerance** - Continue workflow execution on individual failures
  - **AI Tools Compatible** - Perfect for use with n8n AI Tools and automation

  ## Credentials

  To use these nodes, you need to configure the Wuzapi credentials:

  1. **API Token** - Your Wuzapi user token for authentication
  2. **API URL** - The base URL of your Wuzapi instance

  ### Credential Validation

  The credentials are automatically validated when configured. The validation provides real-time information about your Wuzapi session:

  - **Authentication Status** - Confirms API token validity
  - **Session Information** - Shows session name, connection status, and login state
  - **Dynamic Messages** - Example: "Connected to setupautomatizado (Connected, Logged In)"

  3. **Advanced Options** (Optional):
     - **Proxy URL** - HTTP/SOCKS5 proxy for requests
     - **Request Timeout** - Timeout in milliseconds
     - **Retry on Failure** - Enable automatic retries
     - **Max Retries** - Maximum retry attempts

  ### Setting up Wuzapi

  1. Install and run Wuzapi following the [official documentation](https://github.com/asternic/wuzapi)
  2. Create a user with an authentication token
  3. Use the token and API URL in n8n credentials

  ## Nodes Overview

  ### Modular Design

  This package follows a modular design where each node focuses on specific functionality:

  - **Session Management** - Connection, authentication, and configuration
  - **Messaging** - All message sending operations
  - **Chat Operations** - Message management and interactions
  - **User Operations** - User information and presence
  - **Group Management** - Complete group functionality
  - **Webhook Configuration** - Event subscription management
  - **Administration** - User management (admin only)
  - **Event Trigger** - Real-time event reception
  - **Send and Wait** - Interactive approval workflows
  - **AI Integration** - Optimized node for AI Tools and workflows

  ### Key Features

  - ✅ **Complete API Coverage** - All Wuzapi endpoints implemented across 11 specialized nodes
  - 🔄 **Automatic Retry Logic** - Built-in retry mechanism with exponential backoff
  - 🛡️ **Robust Error Handling** - Graceful error handling with detailed messages
  - 🎯 **Type Safety** - Full TypeScript implementation with comprehensive type checking
  - 📦 **Universal Media Support** - Handle all media types with Binary Data, Base64, and URL sources
  - 🔐 **Multi-tenant Support** - Each user has independent WhatsApp sessions
  - ☁️ **S3 Integration** - Optional cloud storage for media files with automatic delivery
  - 🌐 **Proxy Support** - HTTP/SOCKS5 proxy configuration for all operations
  - ⚡ **High Performance** - Optimized for production use with efficient media handling
  - 🎨 **User-Friendly** - Intuitive interface with helpful descriptions and examples
  - 🤖 **Complete AI Integration** - Dedicated AI node with full message type support (11 types)
  - 💬 **Interactive Messages** - Full support for buttons, lists, polls, and stickers
  - 🎯 **Mention System** - Complete mention support for individuals and group-wide mentions
  - 📱 **Media Optimization** - Smart media source detection and URL support for reduced payloads
  - ✅ **Enhanced Validation** - Real-time credential validation with session status
  - 🔧 **Batch Processing** - Efficient processing of multiple operations with error tolerance
  - 🌍 **Multi-format Support** - WebP stickers, VCard contacts, geographic locations
  - 📊 **Group Intelligence** - Advanced group management with polls and administrative controls

  ## Usage Examples

  ### Send a Text Message

  ```javascript
  // Using Wuzapi Message node
  {
    "messageType": "text",
    "phone": "5491155553934",
    "body": "Hello from n8n!"
  }
  ```

  ### Send an Image with Caption

  ```javascript
  // Using Wuzapi Message node
  {
    "messageType": "image",
    "phone": "5491155553934",
    "imageSource": "binary",
    "binaryProperty": "data",
    "caption": "Check out this image!"
  }
  ```

  ### Create a Group

  ```javascript
  // Using Wuzapi Group node
  {
    "operation": "create",
    "groupName": "My n8n Group",
    "participants": "5491155553934,5491155553935"
  }
  ```

  ### Set Up Webhook Trigger

  ```javascript
  // Using Wuzapi Trigger node - Basic setup
  {
    "events": ["Message", "ReadReceipt"],
    "filters": {
      "messageType": "text",
      "isGroup": "false"
    }
  }
  ```

  ### Advanced Trigger Configuration

  ```javascript
  // Complete trigger setup with all features
  {
    "events": ["Message"],
    "filters": {
      "fromPhone": "5521971532700@s.whatsapp.net",
      "chatId": "120363312246943103@g.us",
      "messageType": "media",
      "containsText": "urgent",
      "isGroup": "true",
      "isFromMe": "false",
      "tokenFilter": "setupautomatizado"
    },
    "options": {
      "simplifyOutput": true,
      "includeMediaData": true,
      "parseMessageContent": true,
      "includeRawData": false
    }
  }
  ```

  ### Trigger Output Example

  ```javascript
  // Simplified output for a text message
  {
    "eventType": "Message",
    "token": "setupautomatizado",
    "messageId": "A6BA5FB09055C47722F936C3FC74D98F",
    "chat": "5521971532700@s.whatsapp.net", 
    "sender": "5521971532700@s.whatsapp.net",
    "timestamp": "2025-05-28T06:47:26-03:00",
    "messageType": "text",
    "isFromMe": false,
    "isGroup": false,
    "pushName": "Guilherme Jansen",
    "verifiedName": "Guilherme Jansen - Setup Automatizado",
    "text": "Oi"
  }
  ```

  ### Media Message Output

  ```javascript
  // Output for audio message with S3 and base64 data
  {
    "eventType": "Message",
    "messageType": "ptt",
    "audioUrl": "https://mmg.whatsapp.net/v/...",
    "duration": 3,
    "mimeType": "audio/ogg; codecs=opus",
    "mediaBase64": "T2dnUwACAAAAAAAA...",
    "mediaMimeType": "application/ogg",
    "mediaFileName": "DB56752B6A203E5A96A2E533C4D0A7CF.oga",
    "s3Data": {
      "bucket": "evolution",
      "key": "users/2fb8378b312c1d2dd127e094d9a99115/inbox/...",
      "url": "https://s3.setupautomatizado.com.br/evolution/...",
      "size": 8084
    }
  }
  ```

  ### Interactive Message Output

  ```javascript
  // Output for buttons message
  {
    "eventType": "Message",
    "messageType": "buttons",
    "text": "ESCOLHA O MENU!",
    "buttons": [
      {
        "id": "81ad952f-1085-4d2c-a4b9-de228cfc4117",
        "text": "SUPORTE",
        "type": 1
      },
      {
        "id": "a4767ccb-ded6-4edd-be6a-363972fdaa0f",
        "text": "COMERCIAL",
        "type": 1
      },
      {
        "id": "8f72fd66-1e6f-48bd-a5b5-c509fcc5a9f1",
        "text": "ATENDIMENTO",
        "type": 1
      }
    ]
  }

  // Output for list message
  {
    "eventType": "Message",
    "messageType": "list",
    "title": "<HEADER_TEXT>",
    "text": "<BODY_TEXT>",
    "buttonText": "<BUTTON_TEXT>",
    "sections": [
      {
        "title": "<LIST_SECTION_1_TITLE>",
        "rows": [
          {
            "id": "<LIST_SECTION_1_ROW_1_ID>",
            "title": "<SECTION_1_ROW_1_TITLE>",
            "description": "<SECTION_1_ROW_1_DESC>"
          }
        ]
      }
    ]
  }
  ```

  ### Send AI-Generated Message

  ```javascript
  // Using Wuzapi AI node - Perfect for AI workflows
  {
    "operation": "sendText",
    "phoneNumber": "5491155553934",
    "message": "Hello! This is an AI-generated response from n8n."
  }
  ```

  ### Send Multiple Media Files (AI Batch)

  ```javascript
  // Using Wuzapi AI node with multiple items
  [
    {
      "operation": "sendImage",
      "phoneNumber": "5491155553934",
      "imageSource": "url",
      "imageUrl": "https://example.com/image1.jpg",
      "caption": "AI Analysis Result 1"
    },
    {
      "operation": "sendDocument",
      "phoneNumber": "5491155553935",
      "documentSource": "url", 
      "documentUrl": "https://example.com/report.pdf",
      "fileName": "AI_Report.pdf",
      "caption": "Generated Report"
    }
  ]
  ```

  ### Send Interactive Messages with AI

  ```javascript
  // Send sticker for reactions
  {
    "operation": "sendSticker",
    "phoneNumber": "5491155553934",
    "stickerSource": "url",
    "stickerUrl": "https://example.com/thumbs-up.webp"
  }

  // Send buttons for AI decision tree
  {
    "operation": "sendButtons",
    "phoneNumber": "5491155553934",
    "message": "How can I help you today?",
    "additionalOptions": {
      "mentions": {
        "mentionConfig": [{
          "type": "specific",
          "jids": "5491155553934@s.whatsapp.net"
        }]
      }
    }
  }

  // Send list for AI-generated menu
  {
    "operation": "sendList",
    "phoneNumber": "120363312246943103@g.us",
    "buttonText": "Choose Service",
    "description": "Select the service you need",
    "topText": "AI Assistant Services",
    "footerText": "Powered by AI",
    "listItems": {
      "item": [
        {
          "title": "Technical Support",
          "desc": "Get help with technical issues",
          "rowId": "tech_support"
        },
        {
          "title": "Sales Information", 
          "desc": "Learn about our products",
          "rowId": "sales_info"
        },
        {
          "title": "General Questions",
          "desc": "Ask any general questions",
          "rowId": "general_qa"
        }
      ]
    }
  }

  // Send poll for group decisions
  {
    "operation": "sendPoll",
    "phoneNumber": "120363312246943103@g.us",
    "pollHeader": "Which feature should we prioritize?",
    "pollOptions": "AI Chat Enhancement,Voice Messages,File Sharing,Video Calls"
  }
  ```

  ### AI Tools Integration Examples

  ```javascript
  // Complete AI workflow with mentions and media
  {
    "operation": "sendVideo",
    "phoneNumber": "5491155553934",
    "videoSource": "base64",
    "videoBase64": "data:video/mp4;base64,AAAAIGZ0eXBpc29tAAACAGlzb21pc...",
    "caption": "Here's your AI-generated tutorial video",
    "additionalOptions": {
      "id": "ai_tutorial_001",
      "mentions": {
        "mentionConfig": [{
          "type": "all"
        }]
      }
    }
  }

  // AI processing with binary data from previous nodes
  {
    "operation": "sendDocument",
    "phoneNumber": "5491155553934",
    "documentSource": "binary",
    "documentBinaryProperty": "processed_report",
    "fileName": "AI_Analysis_Report.pdf",
    "caption": "Your personalized AI analysis is ready!"
  }
  ```

  ## Error Handling

  All nodes include comprehensive error handling:

  - **Automatic Retries** - Failed requests are retried with exponential backoff
  - **Continue on Fail** - Option to continue workflow execution on errors
  - **Detailed Error Messages** - Clear error descriptions for debugging
  - **HTTP Status Codes** - Proper status code handling
  - **Authentication Errors** - No retry on authentication failures

  ## Compatibility

  - **n8n Version**: 0.210.0 or higher
  - **Node.js**: 20.15 or higher  
  - **Wuzapi**: Compatible with all Wuzapi versions
  - **WhatsApp**: Supports all current WhatsApp message types including interactive content
  - **Media Formats**: 
    - Images: JPEG, PNG, WebP
    - Videos: MP4, AVI, MOV (H.264 codec recommended)
    - Audio: OGG (Opus), MP3, WAV, AAC
    - Documents: PDF, DOCX, XLSX, TXT, and all file types
    - Stickers: WebP format (recommended), PNG with transparency

  ## Resources

  - [n8n Community Nodes Documentation](https://docs.n8n.io/integrations/community-nodes/)
  - [Wuzapi Documentation](https://github.com/asternic/wuzapi)
  - [Wuzapi API Documentation](https://github.com/asternic/wuzapi/blob/main/API.md)
  - [WhatsApp Business API](https://developers.facebook.com/docs/whatsapp)

  ## Support

  For issues and feature requests, please use the [GitHub issues page](https://github.com/guilhermejansen/n8n-nodes-wuzapi/issues).

  ## License

  [MIT](https://github.com/guilhermejansen/n8n-nodes-wuzapi/blob/master/LICENSE.md)

  ## Author

  Guilherme Jansen - [guilherme@setupautomatizado.com.br](mailto:guilherme@setupautomatizado.com.br)

  ---

  Made with ❤️ for the n8n community

ai_documentation_summary:
  {"purpose":"This n8n community node provides comprehensive integration with Wuzapi, a multi-user and multi-device REST API for WhatsApp, enabling automation of messaging, group management, user operations, and real-time event handling.","capabilities":["Send and receive text, images, audio, video, documents, stickers, locations, contacts, templates, buttons, lists, and polls","Manage WhatsApp groups (create, join, leave, update settings, manage participants)","Handle chat interactions (delete, edit, download media, mark as read, react, set presence)","Manage user profiles and contacts (check availability, get info, avatars, contacts)","Configure webhooks for real-time event listening (messages, read receipts, presence, history sync)","Support for media handling via S3 storage and base64 extraction","Advanced message filtering and content parsing in webhook triggers","Interactive message workflows with approval buttons, custom forms, and wait-time limits","Administrative operations for user management (create, list, delete users)"],"authentication":"API key required (Wuzapi token)","commonUseCases":["Automated customer support via WhatsApp","Multi-device WhatsApp business automation","Real-time event monitoring and response workflows","Group management and announcements","Media file sharing and storage integration"],"limitations":["Community node (not official n8n node)","Requires external Wuzapi instance setup","Some advanced features may depend on Wuzapi server configuration"],"relatedNodes":["n8n-nodes-whatsapp","n8n-nodes-webhook","n8n-nodes-s3"]}


node_type: n8n-nodes-zalo-tools.zalotools
package_name: n8n-nodes-zalo-tools
display_name: zalotools
description: Các node hỗ trợ Zalo cho n8n
category: Community
development_style: declarative
version: 0.6.1
properties_schema: []
operations: []
credentials_required: []
updated_at: 2026-04-16 09:43:37
author_name: dinhtrung1308
author_github_url: git+https://github.com/ChickenAI/zalo-node.git
npm_package_name: n8n-nodes-zalo-tools
npm_version: 0.6.1
community_fetched_at: 2026-04-16T09:43:37.366Z
npm_readme:
  ![Banner image](https://user-images.githubusercontent.com/10284570/173569848-c624317f-42b1-45a6-ab09-f0ea3c247648.png)

  # n8n-nodes-zalo-tools
  Node dành riêng cho n8n này được thiết kế hoạt động hoàn toàn bên trong instance n8n của bạn. Không cần sử dụng API của bên thứ ba hay phụ thuộc ngoại vi nào — chỉ có sự tự động hóa quy trình thuần túy, đảm bảo dữ liệu của bạn luôn được giữ riêng tư và an toàn.

  Node này mô phỏng trình duyệt để tương tác trực tiếp với Zalo Web, cho phép tự động hóa liền mạch ngay trong n8n. Đây là dự án mã nguồn mở, mở rộng cơ hội cho cộng đồng cùng đóng góp ý kiến và phát triển thêm các tính năng mới, nhằm xây dựng hệ thống tự động hóa Zalo tiên tiến, hiệu quả và an toàn hơn.

  ## Buy me a coffee
  Nếu **node** này giúp bạn tiết kiệm thời gian hoặc giải quyết được vấn đề khó nhằn, hãy cân nhắc ủng hộ tôi một ☕ (Buy me a coffee) hoặc đơn giản là nhấn **★ Star** cho dự án.  
  Sự động viên nhỏ ấy sẽ tiếp thêm năng lượng để mình tiếp tục duy trì, cập nhật và phát triển thêm nhiều tính năng hữu ích hơn nữa.  
  Cám ơn bạn rất nhiều! 💛

  ![Alt text](qr.png)
  ## Tác giả
  - Dương Đình Trung - ChickenAI Team

  ## Hướng dẫn cài đặt node này:

  **Community Nodes (Khuyến nghị)**

  Đối với người dùng n8n v0.187+, bạn có thể cài đặt node này trực tiếp từ bảng Community Nodes trong trình soạn thảo n8n.

  1.  Mở trình soạn thảo n8n của bạn.
  2.  Vào Settings > Community Nodes.
  3.  Tìm kiếm "n8n-nodes-zalo-tools".
  4.  Nhấp vào Install.
  5.  Tải lại trình soạn thảo.

  **Cài đặt thủ công**

  Bạn cũng có thể cài đặt node này theo cách thủ công:

  ```
  cd YOUR_N8N_INSTALLATION_DIRECTORY
  npm install n8n-nodes-zalo-tools
  ```

  ## Available Nodes

  1. Zalo Login By QR
  Node cho phép đăng nhập vào Zalo thông qua mã QR.

  2. Zalo Group
  Node quản lý các hoạt động nhóm.
  Operations:
  createGroup: Tạo nhóm mới
  getGroupInfo: Lấy thông tin nhóm
  addGroupDeputy: Thêm phó nhóm
  addUserToGroup: Thêm thành viên
  changeGroupAvatar: Đổi avatar nhóm
  changeGroupName: Đổi tên nhóm
  getGroupMembers: Lấy danh sách thành viên
  getAllGroups: Lấy tất cả nhóm
  removeUserFromGroup: Xóa thành viên

  3. Zalo User
  Node quản lý người dùng và bạn bè.
  Operations:
  acceptFriendRequest: Chấp nhận lời mời kết bạn
  sendFriendRequest: Gửi lời mời kết bạn
  blockUser: Chặn người dùng
  unblockUser: Bỏ chặn người dùng
  changeAccountAvatar: Đổi ảnh đại diện
  changeAccountSetting: Thay đổi cài đặt tài khoản
  getUserInfo: Lấy thông tin người dùng
  getAllFriends: Lấy danh sách bạn bè
  findUser: Tìm kiếm người dùng qua số điện thoại

  4. Zalo Send Message
  Node gửi tin nhắn tới người dùng hoặc nhóm.
  Features:
  Gửi tin nhắn văn bản


  5. Zalo Message Trigger
  Node lắng nghe và xử lý các sự kiện tin nhắn.
  Events:
  Tin nhắn mới
  Tin nhắn nhóm
  Thay đổi trạng thái tin nhắn

  ## Warning and Thanks

  **Please read this carefully before using the Zalo nodes:**

  Lưu ý: việc sử dụng thư viện này đồng nghĩa với việc bạn đang làm trái với chính sách của Zalo và nó có thể khiến cho tài khoản của bạn bị vô hiệu hóa. Chúng tôi sẽ không chịu trách nhiệm nếu điều đó xảy ra, vậy nên hãy cân nhắc trước khi sử dụng.

  We would like to thank ZCA-JS for their work on this library.


  ## License

  [MIT](https://github.com/n8n-io/n8n-nodes-starter/blob/master/LICENSE.md)


node_type: @bitovi/n8n-nodes-google-search.googlesearch
package_name: @bitovi/n8n-nodes-google-search
display_name: googlesearch
description: N8N node to connect to Google Search
category: Community
development_style: declarative
version: 0.2.1
properties_schema: []
operations: []
credentials_required: []
updated_at: 2026-04-16 09:43:37
author_name: bitovi-os
author_github_url: git+https://github.com/bitovi/n8n-nodes-google-search.git
npm_package_name: @bitovi/n8n-nodes-google-search
npm_version: 0.2.1
community_fetched_at: 2026-04-16T09:43:37.366Z
ai_summary_generated_at: 2026-03-25 22:47:20
npm_readme:
  # @bitovi/n8n-nodes-google-search

  This is an n8n community node. It lets you use Google Search in your n8n workflows.

  Google Search is a web search engine that allows you to find information on the internet. This node integrates with Google's Custom Search API to perform programmatic searches.

  [n8n](https://n8n.io/) is a [fair-code licensed](https://docs.n8n.io/reference/license/) workflow automation platform.

  [Installation](#installation)  
  [Operations](#operations)  
  [Credentials](#credentials)  
  [Compatibility](#compatibility)  
  [Usage](#usage)  
  [Resources](#resources)  

  ## Installation

  Follow the [installation guide](https://docs.n8n.io/integrations/community-nodes/installation/) in the n8n community nodes documentation.

  Alternatively:

  - Make sure to allow community nodes with `N8N_COMMUNITY_PACKAGES_ENABLED=true`
  - Once logged in to your N8N web UI, go to `/settings/community-nodes` and type `@bitovi/n8n-nodes-google-search`

  ## Operations

  The Google Search node supports the following operations:

  ### Custom Search

  - **Search Query**: Perform searches using Google's Custom Search API
  - **Return All**: Option to return all results or limit to a specific number
  - **Limit**: Set maximum number of results to return (when Return All is disabled)

  ### Additional Search Parameters

  - **Date Restrict**: Restrict results to a specific time period (past 24 hours, week, month, or year)
  - **Exact Terms**: Search for exact phrases
  - **Exclude Terms**: Exclude specific terms from search results
  - **File Type**: Filter results by file type (e.g., pdf, doc, etc.)
  - **Filter**: Enable/disable duplicate content filter
  - **HQ**: Search for pages that link to a specific URL
  - **Image Color Type**: Filter images by color type (color, gray, black and white, transparent)
  - **Image Dominant Color**: Filter images by dominant color
  - **Image Size**: Filter images by size
  - **Image Type**: Filter by image type (clipart, face, lineart, stock, photo)
  - **Link Site**: Restrict results to pages linking to a specific site
  - **Or Terms**: Search for pages containing any of the specified terms
  - **Related Site**: Find pages related to a specific URL
  - **Rights**: Filter by usage rights
  - **Safe Search Level**: Enable safe search filtering
  - **Search Type**: Specify search type (image search, etc.)
  - **Site Search**: Restrict search to a specific site
  - **Site Search Filter**: Include or exclude results from site search
  - **Sort By**: Sort results by relevance (default) or date

  ## Credentials

  To use this node, you need to authenticate with Google's Custom Search API. You'll need:

  ### Prerequisites

  1. A Google Cloud Platform account
  2. A Google Custom Search Engine set up

  ### Setting up credentials

  1. **Create a Custom Search Engine**:
     - Go to [Google Programmable Search Engine](https://programmablesearchengine.google.com)
     - Create a new search engine
     - Note the Search Engine ID (cx parameter)

  2. **Get API Key**:
     - Go to [Google Cloud Console](https://console.cloud.google.com) or [Programmable Search Engine Guide](https://developers.google.com/custom-search/v1/introduction)
     - Enable the Custom Search API
     - Create an API key
     - Copy the API key

  3. **Configure in n8n**:
     - Search Engine ID: Enter your Custom Search Engine ID
     - API Key: Enter your Google Cloud API key

  ## Compatibility

  - **Minimum n8n version**: Compatible with n8n v0.198.0 and above
  - **Node.js version**: Requires Node.js 18.10 or higher
  - **n8n API version**: Uses n8n nodes API version 1

  This node has been tested with the latest versions of n8n and should work with all current installations.

  ## Usage

  ### Basic Search

  1. Add the Google Search node to your workflow
  2. Configure your credentials (Search Engine ID and API Key)
  3. Enter your search query
  4. Set whether to return all results or limit the number
  5. Execute the workflow

  ### Advanced Search Options

  Use the "Additional Fields" section to:

  - Restrict results to a specific time period (past 24 hours, week, month, etc.)
  - Sort results by date or relevance
  - Filter results by file type, language, or site
  - Search for exact phrases or exclude specific terms
  - Filter images by size, color, or type

  ### Pagination

  The node supports automatic pagination when "Return All" is enabled, allowing you to retrieve large result sets efficiently.

  ### Example Use Cases

  - **Content Research**: Search for articles, papers, or resources on specific topics
  - **Competitor Analysis**: Monitor mentions of your brand or competitors
  - **Lead Generation**: Find contact information or company details
  - **SEO Analysis**: Research keywords and analyze search results
  - **Data Collection**: Gather information from web sources programmatically

  ## Using as an AI Agent Tool

  This node can be used as a tool in n8n's AI Agent workflows, allowing AI assistants to automatically search the web when needed.

  ### Prerequisites

  - n8n version 1.40 or higher (with AI Agent support)
  - Environment variable: `N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE=true`

  ### Setting the Environment Variable

  **For Docker:**

  ```bash
  docker run -e N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE=true n8nio/n8n
  ```

  Or in your `docker-compose.yml`:

  ```yaml
  environment:
    - N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE=true
  ```

  **For npm installation:**

  ```bash
  export N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE=true
  npx n8n start
  ```

  **For Windows (PowerShell):**

  ```powershell
  $env:N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE="true"
  npx n8n start
  ```

  ### Setup Steps

  1. Set the environment variable as shown above
  2. Install this community node through n8n's Community Nodes settings
  3. Restart n8n if it was already running
  4. In your workflow, add an **AI Agent** node
  5. Click **Add Tool** in the AI Agent configuration
  6. Select **Google Search** from the available tools

  ### How It Works

  - The AI agent will automatically call the Google Search tool when it determines a web search is needed
  - The tool returns search results including titles, links, and snippets
  - Results are limited to 50 by default (configurable with the "Limit" parameter)
  - All "Additional Fields" are available for advanced filtering

  ### Tips for AI Tool Usage

  - Use descriptive prompts that might require web searches (e.g., "What are the latest trends in...")
  - The AI will decide when to use the search tool based on the conversation context
  - You can combine this with other tools for comprehensive AI workflows
  - Monitor your Google API quota as the AI may make multiple search requests

  ## Need help or have questions?

  Need guidance on leveraging AI agents or N8N for your business? Our [AI Agents workshop](https://hubs.ly/Q02X-9Qq0) will equip you with the knowledge and tools necessary to implement successful and valuable agentic workflows.

  ## Resources

  - [n8n community nodes documentation](https://docs.n8n.io/integrations/community-nodes/)
  - [Google Custom Search API documentation](https://developers.google.com/custom-search/v1/overview)
  - [Google Programmable Search Engine](https://programmablesearchengine.google.com)
  - [Google Cloud Console](https://console.cloud.google.com)

  ## License

  [MIT](./LICENSE.md)

ai_documentation_summary:
  {"purpose":"This n8n community node enables programmatic web searches using Google's Custom Search API, allowing workflows to retrieve information from the internet.","capabilities":["Execute custom search queries via Google Custom Search API","Filter results by date range (past 24h, week, month, year)","Search for exact phrases or exclude specific terms","Filter results by file type (PDF, DOC, etc.)","Filter images by size, color type, and dominant color","Restrict results to specific sites or link sites","Sort results by relevance or date","Enable safe search filtering","Support automatic pagination for large result sets","Integrate as a tool in AI Agent workflows"],"authentication":"API key required (Google Cloud API key and Custom Search Engine ID)","commonUseCases":["Content research and information gathering","Competitor analysis and brand monitoring","Lead generation and contact information retrieval","SEO keyword analysis","Automated web data collection"],"limitations":["Requires Google Cloud Platform account and Custom Search Engine setup","Requires n8n v0.198.0+ (v1.40+ for AI Agent tool usage)","Requires Node.js 18.10 or higher","Community node requires enabling community packages in n8n settings","AI Agent tool usage requires additional environment variable configuration"],"relatedNodes":["AI Agent node","HTTP Request node","Webhook node"]}


node_type: @bitovi/n8n-nodes-utils.utils
package_name: @bitovi/n8n-nodes-utils
display_name: utils
description: N8N util nodes from Bitovi
category: Community
development_style: declarative
version: 0.3.1
properties_schema: []
operations: []
credentials_required: []
updated_at: 2026-04-16 09:43:37
author_name: bitovi-os
author_github_url: git+https://github.com/bitovi/n8n-nodes-utils.git
npm_package_name: @bitovi/n8n-nodes-utils
npm_version: 0.3.1
community_fetched_at: 2026-04-16T09:43:37.367Z
ai_summary_generated_at: 2026-03-25 22:47:20
npm_readme:
  # @bitovi/n8n-nodes-utils

  This is an n8n community node package that provides utility nodes for enhancing your n8n workflows. It includes nodes for JSON schema validation, regex operations, data manipulation, and Wikipedia integration.

  [n8n](https://n8n.io/) is a [fair-code licensed](https://docs.n8n.io/reference/license/) workflow automation platform.

  [Installation](#installation)  
  [Operations](#operations)  
  [Compatibility](#compatibility)  
  [Usage](#usage)  
  [Resources](#resources)  

  ## Installation

  Follow the [installation guide](https://docs.n8n.io/integrations/community-nodes/installation/) in the n8n community nodes documentation.

  ### Quick Installation

  1. Make sure to allow community nodes with `N8N_COMMUNITY_PACKAGES_ENABLED=true`
  2. Once logged in to your N8N web UI, go to `/settings/community-nodes` and type `@bitovi/n8n-nodes-utils`
  3. Click install and restart your n8n instance

  ## Operations

  This package includes the following utility nodes:

  ### JSONSchema Validation
  Validates JSON data against a provided JSON schema using the AJV library.

  ### Regex
  Perform regular expression operations on text data.
  - **Get Matches**: Extract all matches from text using a regex pattern
  - **Replace**: Replace text using regex patterns with support for capture groups

  ### Skip
  Skip a specified number of items from the input data stream.
  - **Data filtering**: Remove the first N items from your data flow
  - **Pagination support**: Useful for implementing pagination or data chunking

  ### Wikipedia
  Integrate with Wikipedia to fetch content and metadata.
  - **Get Content**: Retrieve the full content of a Wikipedia page
  - **Get Links**: Extract all links from a Wikipedia page
  - These automatically suggest the closest matching page name and follow redirects to the correct page

  ## Compatibility

  - **Minimum n8n version**: Compatible with n8n API version 1
  - **Node.js version**: Requires Node.js >= 18.10
  - **Package manager**: Uses pnpm >= 9.1

  This package has been tested with recent versions of n8n and follows the community node standards.

  ## Usage

  ### JSONSchema Validation Example
  Use this node to validate API responses or user input data:
  ```json
  {
    "type": "object",
    "properties": {
      "name": { "type": "string" },
      "age": { "type": "number", "minimum": 0 },
      "email": { "type": "string", "format": "email" }
    },
    "required": ["name", "email"]
  }
  ```

  ### Regex Example
  Extract email addresses from text:
  - **Pattern**: `[\w\.-]+@[\w\.-]+\.\w+`
  - **Flags**: `g` (global to find all matches)

  ### Wikipedia Integration
  Fetch content about a topic for AI processing or content generation:
  - Set **Page Name** to your topic of interest
  - Enable **Auto Suggest** for fuzzy matching
  - Use **Get Content** for full article text or **Get Links** for related topics

  ## Need help or have questions?

  Need guidance on leveraging AI agents or N8N for your business? Our [AI Agents workshop](https://hubs.ly/Q02X-9Qq0) will equip you with the knowledge and tools necessary to implement successful and valuable agentic workflows.

  ## Resources

  - [n8n community nodes documentation](https://docs.n8n.io/integrations/community-nodes/)
  - [AJV JSON Schema Validator](https://ajv.js.org/)
  - [Wikipedia API](https://github.com/dopecodez/Wikipedia)
  - [Bitovi GitHub Repository](https://github.com/bitovi/n8n-nodes-utils)

  ## License

  [MIT](./LICENSE.md)

ai_documentation_summary:
  {"purpose":"Provides utility nodes for n8n workflows including JSON schema validation, regex operations, data filtering, and Wikipedia integration.","capabilities":["JSON schema validation using AJV library","Regular expression matching and extraction","Text replacement with regex capture groups","Skipping N items from data stream","Wikipedia content fetching","Wikipedia link extraction","Auto-suggest for Wikipedia page matching"],"authentication":"None","commonUseCases":["Validating API responses against JSON schemas","Extracting data patterns from text","Implementing pagination in data flows","Fetching Wikipedia content for AI processing"],"limitations":["Requires Node.js >= 18.10","Requires pnpm >= 9.1","Compatible with n8n API version 1"],"relatedNodes":["n8n core nodes","JSON Schema validator","Regex node","Wikipedia node"]}


node_type: @bitovi/n8n-nodes-langfuse.langfuse
package_name: @bitovi/n8n-nodes-langfuse
display_name: langfuse
description: n8n node to process Langfuse configuration files
category: Community
development_style: declarative
version: 0.1.0
properties_schema: []
operations: []
credentials_required: []
updated_at: 2026-04-16 09:43:37
author_name: bitovi-os
author_github_url: git+https://github.com/bitovi/n8n-nodes-langfuse.git
npm_package_name: @bitovi/n8n-nodes-langfuse
npm_version: 0.1.0
community_fetched_at: 2026-04-16T09:43:37.368Z
ai_summary_generated_at: 2026-03-25 22:47:20
npm_readme:
  # @bitovi/n8n-nodes-langfuse

  This repo contains [N8N](https://n8n.io/) node to work with Langfuse.

  ## Installation

  - Make sure to allow community nodes with `N8N_COMMUNITY_PACKAGES_ENABLED=true`
  - Once logged in to your N8N web UI, go to `/settings/community-nodes` and type `@bitovi/n8n-nodes-langfuse`

  ## Need help or have questions?

  Need guidance on leveraging AI agents or N8N for your business? Our [AI Agents workshop](https://hubs.ly/Q02X-9Qq0) will equip you with the knowledge and tools necessary to implement successful and valuable agentic workflows.

  ## License

  [MIT](./LICENSE.md)

ai_documentation_summary:
  {"purpose":"Processes Langfuse configuration files to enable integration with the Langfuse observability platform within n8n workflows.","capabilities":["Load Langfuse configuration files","Initialize Langfuse connections","Support community node installation via n8n web UI"],"authentication":"None (configuration-based)","commonUseCases":["AI model observability setup","LLM prompt tracking configuration","Agent workflow monitoring initialization"],"limitations":["Requires manual configuration file setup","Limited to configuration processing (no direct API operations mentioned)"],"relatedNodes":["langfuse","community-nodes","ai-agents-workshop"]}


node_type: @bitovi/n8n-nodes-markitdown.markitdown
package_name: @bitovi/n8n-nodes-markitdown
display_name: markitdown
description: n8n node to process files with Markitdown
category: Community
development_style: declarative
version: 0.1.10
properties_schema: []
operations: []
credentials_required: []
updated_at: 2026-04-16 09:43:37
author_name: bitovi-os
author_github_url: git+https://github.com/bitovi/n8n-nodes-markitdown.git
npm_package_name: @bitovi/n8n-nodes-markitdown
npm_version: 0.1.10
community_fetched_at: 2026-04-16T09:43:37.369Z
npm_readme:
  # @bitovi/n8n-nodes-markitdown

  This is an n8n community node. It lets you use Microsoft's Markitdown in your n8n workflows.

  Microsoft's [Markitdown](https://github.com/microsoft/markitdown) is a powerful utility for converting various document formats (PDF, Word, PowerPoint, Excel, images, audio, and more) into clean, structured Markdown text. This makes it easy to extract and process content from different file types in your automation workflows.

  [n8n](https://n8n.io/) is a [fair-code licensed](https://docs.n8n.io/reference/license/) workflow automation platform.

  [Installation](#installation)  
  [Operations](#operations)  
  [Compatibility](#compatibility)  
  [Usage](#usage)  
  [Resources](#resources)  
  [Version history](#version-history)

  ## Installation

  Follow the [installation guide](https://docs.n8n.io/integrations/community-nodes/installation/) in the n8n community nodes documentation.

  #### Requirements

  - A self-hosted n8n instance.
     - n8n Cloud [does not support nodes with external dependencies](https://community.n8n.io/t/custom-node-approval/118559?utm_source=chatgpt.com)
  - Make sure you have [Markitdown](https://github.com/bitovi/n8n-nodes-markitdown) installed
     2. Simply update your own Dockerfile with the delcarations below
     1. You may use our [custom image](https://hub.docker.com/r/bitovi/n8n-nodes-markitdown)
  - Make sure to allow community nodes with `N8N_COMMUNITY_PACKAGES_ENABLED=true`
  - Once logged in to your N8N web UI, go to `/settings/community-nodes` and type `@bitovi/n8n-nodes-markitdown`

  ### Option 1 (Recommended) - Use our pre-built Docker image

  ```dockerfile
  # Use our custom image
  FROM bitovi/n8n-nodes-markitdown:latest

  # Optional, put your customization here
  ...
  ```

  ### Option 2 - Add to your existing Dockerfile
  ```dockerfile
  FROM n8nio/n8n:latest

  # Switch to the root user for installations
  USER root
  RUN npm install -g pnpm

  # === Python Dependencies for Alpine ===
  # This uses Alpine's 'apk' package manager.
  # 1. Create a temporary virtual package '.build-deps' with all build dependencies.
  # 2. Use pip to install markitdown globally, adding '--break-system-packages' to handle PEP 668.
  # 3. Ensure Python runtime packages remain installed.
  # 4. Remove only the build dependencies to keep the image smaller.
  RUN apk add --no-cache --virtual .build-deps git build-base python3-dev py3-pip && \
      apk add --no-cache python3 && \
      pip install markitdown --break-system-packages && \
      apk del .build-deps

  # Ensure the Python scripts directory is in PATH for all users
  ENV PATH="/usr/local/bin:$PATH"

  # Switch back to the non-privileged 'node' user for security
  USER node

  # Set the working directory to n8n's default
  WORKDIR /home/node/.n8n/nodes

  # Install the n8n Markitdown nodes package
  RUN npm install @bitovi/n8n-nodes-markitdown@latest --only=prod

  # Set the main working directory back to n8n's default
  WORKDIR /home/node
  ```

  ## Operations

  This node provides a single operation:

  **Convert to Markdown**: Takes any supported file format and converts it to clean, structured Markdown text.

  **Input Parameters:**
  - **Input Binary Field**: The name of the binary property containing the file to process (default: "data")

  **Output:**
  - **data**: The converted Markdown content as a string in the JSON output
  - **binary**: Empty binary object (the output is provided as text in the JSON data)

  ## Compatibility

  - **Minimum n8n version**: 1.0.0
  - **Node.js version**: >=18.10
  - **Python version**: 3.7+ (required for markitdown)
  - **Tested with**: n8n 1.14.1+

  This node requires Python and the markitdown package to be installed in your n8n environment. See the installation instructions above for proper setup.

  ## Usage

  ### Basic Workflow Setup

  1. **File Input**: Connect a node that provides binary file data (like "Read Binary File", "HTTP Request", or "Google Drive" nodes)
  2. **Markitdown Node**: Add the Markitdown node to your workflow
  3. **Configure**: Set the "Input Binary Field" parameter to match the binary property name from your input node (usually "data")
  4. **Output**: The converted Markdown will be available in the `data` field of the output JSON

  ### Example Use Cases

  - **Document Processing**: Convert Word documents, PDFs, or PowerPoint presentations to Markdown for further text processing
  - **Content Extraction**: Extract text content from images using OCR capabilities
  - **Data Pipeline**: Batch convert multiple documents as part of a larger data processing workflow
  - **Content Management**: Convert various document formats to Markdown for publishing or archival systems

  ### Tips

  - The node processes files by creating temporary files, so ensure your n8n instance has sufficient disk space
  - Large files may take longer to process depending on the complexity and type of document
  - If processing fails, check that the markitdown command is properly installed and accessible in your environment

  ### How to find the node

  You can search "markitdown" in the n8n node search bar. The node will appear with the Microsoft logo.

  ![Markitdown Node](markitdown.png)

  ## File Types Supported

  MarkItDown supports a wide variety of file formats:

  - **PDF**: Extract text and structure from PDF documents
  - **Microsoft Office**: PowerPoint (reading in top-to-bottom, left-to-right order), Word, Excel
  - **Images**: EXIF metadata extraction and OCR text recognition
  - **Audio**: EXIF metadata and speech transcription
  - **Web**: HTML pages and content
  - **Text-based formats**: CSV, JSON, XML
  - **Archives**: ZIP files (iterates over contents)
  - **Online content**: YouTube URLs
  - **And more!**

  ## Resources

  - [n8n community nodes documentation](https://docs.n8n.io/integrations/community-nodes/)
  - [Microsoft Markitdown GitHub repository](https://github.com/microsoft/markitdown)
  - [Bitovi's n8n-nodes-markitdown repository](https://github.com/bitovi/n8n-nodes-markitdown)
  - [Bitovi Docker Hub image](https://hub.docker.com/r/bitovi/n8n-nodes-markitdown)


  ## Need Help or Have Questions?

  Need guidance on leveraging AI agents or N8N for your business? Our [AI Agents workshop](https://hubs.ly/Q02X-9Qq0) will equip you with the knowledge and tools necessary to implement successful and valuable agentic workflows.

  ## License

  [MIT](./LICENSE.md)


node_type: n8n-nodes-uazapi.uazapi
package_name: n8n-nodes-uazapi
display_name: uazapi
description: n8n community node for UazAPI - Complete WhatsApp automation with 90+ endpoints
category: Community
development_style: declarative
version: 1.0.4
properties_schema: []
operations: []
credentials_required: []
updated_at: 2026-04-16 09:43:37
author_name: aifocus
author_github_url: git+https://github.com/aifocusdev/n8n-nodes-uazapi.git
npm_package_name: n8n-nodes-uazapi
npm_version: 1.0.4
community_fetched_at: 2026-04-16T09:43:37.370Z
ai_summary_generated_at: 2026-03-25 22:47:20
npm_readme:
  # n8n-nodes-uazapi

  [![NPM Version](https://img.shields.io/npm/v/n8n-nodes-uazapi)](https://www.npmjs.com/package/n8n-nodes-uazapi)
  [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
  [![Downloads](https://img.shields.io/npm/dm/n8n-nodes-uazapi)](https://www.npmjs.com/package/n8n-nodes-uazapi)
  [![GitHub Stars](https://img.shields.io/github/stars/aifocusdev/n8n-nodes-uazapi?style=social)](https://github.com/aifocusdev/n8n-nodes-uazapi)

  > **Community node for n8n** - Integração completa com UazAPI para automação WhatsApp

  <div align="center">

  **💝 Projeto Open Source Gratuito** | [⭐ Dê uma Estrela](#) | [💰 Apoie via PIX](#-apoie-o-projeto)

  **Desenvolvido com ❤️ por [AI Focus Company](https://github.com/aifocusdev)**

  </div>

  Este é um node da comunidade n8n que fornece integração completa com a [UazAPI](https://uazapi.com), permitindo automação avançada do WhatsApp Business com mais de 90 endpoints disponíveis.

  ## 📋 Índice

  - [Características](#-características)
  - [Instalação](#-instalação)
  - [Credenciais](#-credenciais)
  - [Operações Disponíveis](#-operações-disponíveis)
  - [Exemplos de Uso](#-exemplos-de-uso)
  - [Desenvolvimento](#-desenvolvimento)
  - [Contribuindo](#-contribuindo)
  - [Licença](#-licença)

  ## ✨ Características

  ### 🖥️ **Gerenciamento de Instâncias**
  - Criar nova instância WhatsApp
  - Conectar ao WhatsApp (QR Code ou código de pareamento)
  - Verificar status da conexão
  - Desconectar e deletar instâncias
  - Listar todas as instâncias
  - Atualizar nome da instância

  ### 💬 **Mensagens**
  - **Texto:** Envio simples com preview de links
  - **Mídia:** Imagens, vídeos, áudios, documentos, PTT, stickers
  - **Contatos:** Envio de vCard
  - **Localização:** Coordenadas geográficas
  - **Menus Interativos:** Botões, listas, enquetes
  - **Stories/Status:** Publicação de status
  - **Ações:** Reagir, editar, deletar, marcar como lida

  ### 🚀 **Campanhas em Massa**
  - Disparo simples com mesma mensagem
  - Disparo avançado com personalização
  - Controle de campanhas (pausar, continuar, parar)
  - Delays aleatórios anti-ban
  - Agendamento de envios
  - Relatórios detalhados

  ### 👥 **Grupos WhatsApp**
  - Criar e gerenciar grupos
  - Adicionar/remover participantes
  - Promover/rebaixar administradores
  - Atualizar nome e descrição
  - Gerenciar links de convite
  - Listar todos os grupos

  ### 💬 **Gestão de Chats**
  - Arquivar/desarquivar conversas
  - Fixar chats importantes
  - Silenciar notificações
  - Deletar conversas
  - Marcar como lido
  - Buscar chats com filtros
  - Verificar números no WhatsApp

  ### 📞 **Contatos**
  - Listar contatos da agenda
  - Adicionar novos contatos
  - Remover contatos
  - Obter detalhes completos

  ### 🏷️ **Etiquetas/Labels**
  - Listar todas as etiquetas
  - Gerenciar etiquetas de chats
  - Editar etiquetas existentes

  ### 🤖 **Chatbot com IA**
  - Configurar chatbot inteligente
  - Criar agentes de IA personalizados
  - Suporte a múltiplos provedores:
    - **OpenAI** (GPT-4, GPT-4o-mini)
    - **Anthropic** (Claude 3.5 Sonnet)
    - **Google** (Gemini Pro)
    - **DeepSeek**
  - Gerenciar base de conhecimento
  - Criar funções para APIs externas

  ## 📦 Instalação

  ### Via n8n Community Nodes (Recomendado)

  1. Acesse o n8n
  2. Vá em **Settings** → **Community Nodes**
  3. Clique em **Install**
  4. Digite: `n8n-nodes-uazapi`
  5. Clique em **Install**

  ### Via NPM (Manual)

  ```bash
  npm install n8n-nodes-uazapi
  ```

  ### Via Docker

  Adicione ao seu `Dockerfile`:

  ```dockerfile
  FROM n8nio/n8n

  # Instalar node da comunidade
  RUN cd /usr/local/lib/node_modules/n8n && \
      npm install n8n-nodes-uazapi
  ```

  ## 🔐 Credenciais

  Para usar este node, você precisa configurar as credenciais da UazAPI:

  ### 1. Obter Credenciais

  1. Acesse [seudominio.uazapi.com](https://seudominio.uazapi.com)
  2. Crie uma conta ou faça login
  3. Obtenha seu **Admin Token**
  4. Ao criar uma instância, você receberá um **Instance Token**

  ### 2. Configurar no n8n

  1. No workflow, clique no node **UazAPI**
  2. Clique em **Create New Credentials**
  3. Preencha os campos:
     - **Base URL:** `https://seudominio.uazapi.com` (padrão)
     - **Admin Token:** Seu token de administrador (para criar/listar instâncias)
     - **Instance Token:** Token da instância específica (opcional - para operações de mensagens)

  > **💡 Dica:** Você pode usar variáveis do n8n para gerenciar múltiplas instâncias:
  > - Crie credenciais diferentes para cada instância
  > - Use expressões para selecionar dinamicamente a credencial

  ## 🎯 Operações Disponíveis

  ### Instance (Instâncias)
  - ✅ Create - Criar nova instância
  - ✅ Connect - Conectar ao WhatsApp
  - ✅ Get Status - Verificar status
  - ✅ Disconnect - Desconectar
  - ✅ Delete - Deletar instância
  - ✅ List All - Listar todas
  - ✅ Update Name - Renomear instância

  ### Message (Mensagens)
  - ✅ Send Text - Texto simples
  - ✅ Send Media - Imagem/vídeo/áudio/documento
  - ✅ Send Contact - Cartão vCard
  - ✅ Send Location - Localização GPS
  - ✅ Send Menu - Botões/listas/enquetes
  - ✅ Send Status - Story/Status
  - ✅ React to Message - Enviar emoji
  - ✅ Edit Message - Editar texto
  - ✅ Delete Message - Apagar para todos
  - ✅ Download Media - Baixar arquivo
  - ✅ Mark as Read - Marcar como lida

  ### Campaign (Disparos em Massa)
  - ✅ Create Simple - Campanha básica
  - ✅ Create Advanced - Com personalização
  - ✅ Control Campaign - Pausar/continuar/parar
  - ✅ List Campaigns - Listar todas
  - ✅ List Messages - Mensagens da campanha
  - ✅ Clear Sent - Limpar antigas

  ### Group (Grupos)
  - ✅ Create - Criar grupo
  - ✅ Get Info - Informações do grupo
  - ✅ List All - Listar grupos
  - ✅ Update Participants - Gerenciar membros
  - ✅ Update Name - Alterar nome
  - ✅ Update Description - Alterar descrição
  - ✅ Leave Group - Sair do grupo
  - ✅ Get Invite Link - Link de convite

  ### Chat (Conversas)
  - ✅ Archive - Arquivar/desarquivar
  - ✅ Delete - Deletar chat
  - ✅ Mark as Read - Marcar como lido
  - ✅ Pin - Fixar/desafixar
  - ✅ Mute - Silenciar
  - ✅ Find - Buscar chats
  - ✅ Check Number - Verificar WhatsApp

  ### Contact (Contatos)
  - ✅ List All - Listar contatos
  - ✅ Add - Adicionar contato
  - ✅ Remove - Remover contato
  - ✅ Get Details - Obter detalhes

  ### Label (Etiquetas)
  - ✅ List All - Listar etiquetas
  - ✅ Manage Chat - Gerenciar por chat
  - ✅ Edit - Editar etiqueta

  ### Chatbot (IA)
  - ✅ Update Settings - Configurar chatbot
  - ✅ Create Agent - Criar agente IA
  - ✅ List Agents - Listar agentes
  - ✅ Create Knowledge - Base de conhecimento
  - ✅ List Knowledge - Listar conhecimentos

  ## 📖 Exemplos de Uso

  ### Exemplo 1: Enviar Mensagem de Texto

  ```javascript
  // Configuração do node
  Resource: Message
  Operation: Send Text
  Number: 5511999999999
  Text: Olá! Esta é uma mensagem enviada via n8n + UazAPI
  ```

  ### Exemplo 2: Criar Campanha de Disparo

  ```javascript
  // Configuração do node
  Resource: Campaign
  Operation: Create Simple
  Numbers: 5511999999999, 5511888888888, 5511777777777
  Message Type: text
  Message Text: Olá {{nome}}! Promoção especial para você!
  Delay Min: 10
  Delay Max: 30
  ```

  ### Exemplo 3: Criar Grupo e Adicionar Membros

  ```javascript
  // Node 1: Criar Grupo
  Resource: Group
  Operation: Create
  Group Name: Meu Grupo Automático
  Participants: 5511999999999, 5511888888888

  // Node 2: Enviar Mensagem de Boas-vindas
  Resource: Message
  Operation: Send Text
  Number: {{$node["Criar Grupo"].json["groupJid"]}}
  Text: Bem-vindos ao grupo!
  ```

  ### Exemplo 4: Chatbot com IA (GPT-4)

  ```javascript
  // Node 1: Configurar Chatbot
  Resource: Chatbot
  Operation: Update Settings
  OpenAI API Key: sk-...
  Chatbot Enabled: true

  // Node 2: Criar Agente
  Resource: Chatbot
  Operation: Create Agent
  Agent Name: Atendente Virtual
  AI Provider: openai
  Model: gpt-4o-mini
  System Prompt: Você é um assistente de atendimento amigável...
  ```

  ### Exemplo 5: Workflow Completo - Auto-Resposta

  ```
  Webhook Trigger (Recebe mensagem)
    ↓
  IF (mensagem contém "oi" ou "olá")
    ↓
  UazAPI - Send Text (Responde automaticamente)
    ↓
  UazAPI - Mark as Read (Marca como lida)
  ```

  ### Exemplo 6: Disparos com CSV

  ```
  Read Binary File (CSV com contatos)
    ↓
  Split In Batches (Lotes de 50)
    ↓
  Loop Over Items (Para cada contato)
    ↓
  UazAPI - Send Text (Personalizado)
    ↓
  Wait (Delay aleatório 10-30s)
  ```

  ## 🛠️ Desenvolvimento

  ### Requisitos

  - Node.js 18+
  - npm ou yarn
  - n8n instalado localmente

  ### Setup do Projeto

  ```bash
  # Clonar repositório
  git clone https://github.com/seu-usuario/n8n-nodes-uazapi.git
  cd n8n-nodes-uazapi

  # Instalar dependências
  npm install

  # Build
  npm run build

  # Linkar localmente para testes
  npm link
  cd ~/.n8n
  npm link n8n-nodes-uazapi

  # Iniciar n8n
  n8n start
  ```

  ### Scripts Disponíveis

  ```bash
  npm run build      # Compilar TypeScript
  npm run dev        # Watch mode
  npm run lint       # Verificar código
  npm run lintfix    # Corrigir problemas
  npm run format     # Formatar código
  npm test           # Executar testes
  ```

  ### Estrutura do Projeto

  ```
  n8n-nodes-uazapi/
  ├── credentials/
  │   └── UazApiApi.credentials.ts
  ├── nodes/
  │   └── UazApi/
  │       ├── UazApi.node.ts
  │       └── uazapi.svg
  ├── package.json
  ├── tsconfig.json
  ├── gulpfile.js
  └── README.md
  ```

  ## 🤝 Contribuindo

  Contribuições são bem-vindas! Para contribuir:

  1. Fork o projeto
  2. Crie uma branch para sua feature (`git checkout -b feature/MinhaFeature`)
  3. Commit suas mudanças (`git commit -m 'Adiciona MinhaFeature'`)
  4. Push para a branch (`git push origin feature/MinhaFeature`)
  5. Abra um Pull Request

  ### Diretrizes

  - Siga o estilo de código do projeto (ESLint + Prettier)
  - Adicione testes para novas funcionalidades
  - Atualize a documentação conforme necessário
  - Mantenha commits atômicos e descritivos

  ## 🐛 Reportar Bugs

  Encontrou um bug? Por favor, abra uma [issue](https://github.com/seu-usuario/n8n-nodes-uazapi/issues) com:

  - Descrição detalhada do problema
  - Passos para reproduzir
  - Versão do n8n e do node
  - Screenshots (se aplicável)

  ## 📝 Changelog

  ### v1.0.0 (2025-01-XX)

  **Adicionado:**
  - ✨ Implementação inicial com 90+ endpoints
  - 🔐 Sistema de credenciais com admin token e instance token
  - 📱 Operações de instância (criar, conectar, status, deletar)
  - 💬 Envio de mensagens (texto, mídia, contato, localização)
  - 🚀 Sistema de campanhas em massa
  - 👥 Gerenciamento completo de grupos
  - 💬 Gestão de chats e conversas
  - 📞 Operações de contatos
  - 🏷️ Sistema de etiquetas
  - 🤖 Chatbot com IA (OpenAI, Claude, Gemini, DeepSeek)
  - 📚 Base de conhecimento para IA
  - 🎨 Interface visual intuitiva
  - 📖 Documentação completa

  ## 🔗 Links Úteis

  - [Documentação UazAPI](https://docs.uazapi.com)
  - [n8n Community Nodes](https://docs.n8n.io/integrations/community-nodes/)
  - [GitHub Repository](https://github.com/seu-usuario/n8n-nodes-uazapi)
  - [NPM Package](https://www.npmjs.com/package/n8n-nodes-uazapi)

  ## 💬 Suporte e Contato

  ### 📧 Contato
  - **Empresa:** AI Focus Company
  - **Desenvolvedor:** Paulo Henrique
  - **Email:** aifocusdev@gmail.com
  - **GitHub:** [@aifocusdev](https://github.com/aifocusdev)

  ### 🐛 Reportar Problemas
  - **Issues:** [GitHub Issues](https://github.com/aifocusdev/n8n-nodes-uazapi/issues)
  - **Discussões:** [GitHub Discussions](https://github.com/aifocusdev/n8n-nodes-uazapi/discussions)

  ### 💡 Sugestões e Melhorias
  Abra uma issue ou discussão no GitHub. Todas as contribuições são bem-vindas!

  ---

  ## 💰 Apoie o Projeto

  Se este projeto foi útil para você ou sua empresa, considere apoiar o desenvolvimento!

  ### ☕ Contribua via PIX

  Sua contribuição ajuda a manter este projeto gratuito e open source!

  ```
  PIX (Celular): (99) 99229-1983
  Favorecido: Paulo Henrique
  Empresa: AI Focus Company
  ```

  **Outras formas de apoiar:**
  - ⭐ Dê uma estrela no GitHub
  - 🐛 Reporte bugs e sugira melhorias
  - 📝 Contribua com código
  - 📢 Compartilhe o projeto com outros desenvolvedores
  - 💬 Ajude outros usuários nas discussões

  Toda contribuição, por menor que seja, faz diferença! 🙏

  ---

  ## 📜 Licença

  Este projeto está licenciado sob a licença MIT - veja o arquivo [LICENSE](LICENSE) para detalhes.

  ## 👏 Agradecimentos

  - Equipe [n8n](https://n8n.io) pela plataforma incrível
  - Equipe [UazAPI](https://uazapi.com) pela API robusta
  - Comunidade open source
  - A todos que contribuíram com doações e feedback

  ---

  <div align="center">

  **Desenvolvido com ❤️ por [AI Focus Company](https://github.com/aifocusdev)**

  **Paulo Henrique** | aifocusdev@gmail.com

  Se este projeto foi útil, considere dar uma ⭐ no GitHub e contribuir via PIX!

  [![GitHub Stars](https://img.shields.io/github/stars/aifocusdev/n8n-nodes-uazapi?style=social)](https://github.com/aifocusdev/n8n-nodes-uazapi)
  [![NPM Version](https://img.shields.io/npm/v/n8n-nodes-uazapi)](https://www.npmjs.com/package/n8n-nodes-uazapi)
  [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

  </div>

ai_documentation_summary:
  {"purpose":"A community n8n node that provides complete integration with UazAPI for advanced WhatsApp Business automation, supporting over 90 endpoints for messaging, campaigns, groups, and AI chatbots.","capabilities":["Create, connect, disconnect, and manage WhatsApp instances","Send text, media, contacts, locations, and interactive menus","Post stories and react to messages","Execute mass campaigns with personalization and anti-ban delays","Create and manage WhatsApp groups and participants","Archive, pin, mute, and search chats","Manage contact lists and labels","Deploy AI chatbots with support for OpenAI, Anthropic, Google, and DeepSeek","Create custom AI agents and external API functions"],"authentication":"API Token (Admin Token and Instance Token required)","commonUseCases":["Automated customer support via WhatsApp","Marketing campaigns and broadcast messaging","AI-powered chatbots for business inquiries","Automated group management and announcements","Lead nurturing through scheduled messages"],"limitations":["Community node (not official n8n node)","Requires UazAPI account and tokens","May have rate limits based on UazAPI service"],"relatedNodes":["n8n-nodes-whatsapp","n8n-nodes-ai","n8n-nodes-http-request"]}


node_type: n8n-nodes-playwright.playwright
package_name: n8n-nodes-playwright
display_name: playwright
description: n8n-community-node-package for browser automation using Playwright
category: Community
development_style: declarative
version: 0.2.21
properties_schema: []
operations: []
credentials_required: []
updated_at: 2026-04-16 09:43:37
author_name: toema
author_github_url: git+https://github.com/toema/n8n-playwright.git
npm_package_name: n8n-nodes-playwright
npm_version: 0.2.21
community_fetched_at: 2026-04-16T09:43:37.371Z
ai_summary_generated_at: 2026-03-25 22:47:20
npm_readme:
  # n8n-nodes-playwright

  This is an n8n community node. It lets you automate browser actions using Playwright in your n8n workflows.

  [n8n](https://n8n.io/) is a [fair-code licensed](https://docs.n8n.io/reference/license/) workflow automation platform.

  [Installation](#installation)  
  [Operations](#operations)  
  [Custom Scripts](#custom-scripts)  
  [Compatibility](#compatibility)  
  [Resources](#resources)  
  [Version history](#version-history)  

  ## Installation

  Follow the [installation guide](https://docs.n8n.io/integrations/community-nodes/installation/) in the n8n community nodes documentation.

  ```bash
  pnpm install n8n-nodes-playwright
  ```

  **Note:** The package will automatically download and set up the required browser binaries during installation. This requires approximately 1GB of disk space.

  If you need to manually trigger the browser setup:

  ```bash
  pnpm rebuild n8n-nodes-playwright
  ```

  ## Operations

  This node supports the following operations:

  ### Standard Operations

  - **Navigate**: Go to a specified URL and retrieve page content
  - **Take Screenshot**: Capture a screenshot of a webpage (full page or viewport)
  - **Get Text**: Extract text from an element using CSS selector or XPath
  - **Click Element**: Click on an element using CSS selector or XPath
  - **Fill Form**: Fill a form field using CSS selector or XPath
  - **Run Custom Script**: Execute custom JavaScript code with full Playwright API access

  ### Browser Options

  - Choose between **Chromium**, **Firefox**, or **WebKit**
  - Configure **headless mode**
  - Adjust operation speed with **slow motion** option

  ### Selector Options

  For `Get Text`, `Click Element`, and `Fill Form` operations, you can choose between:

  - **CSS Selector**: Standard CSS selectors (e.g., `#submit-button`, `.my-class`, `button[type="submit"]`)
  - **XPath**: XPath expressions (e.g., `//button[@id="submit"]`, `//div[contains(@class, "content")]`)

  ### Screenshot Options

  - Full page capture
  - Custom save path
  - Base64 output

  ## Custom Scripts

  The **Run Custom Script** operation gives you complete control over Playwright to automate complex browser interactions, scrape data, generate PDFs/screenshots, and more. Scripts run in a sandboxed environment with access to the full Playwright API and n8n's Code node features.

  ### Available Variables

  Access Playwright-specific objects using:

  - `$page` - Current page instance
  - `$browser` - Browser instance
  - `$playwright` - Playwright library
  - `$helpers` - n8n helper methods (including `prepareBinaryData`)

  Plus all special variables and methods from the Code node are available:
  - `$json` - Current item's JSON data
  - `$input` - Access to input data
  - `$getNodeParameter()` - Get node parameters
  - And more from [n8n documentation](https://docs.n8n.io/code-examples/methods-variables-reference/)

  ### Script Examples

  #### Basic Navigation and Data Extraction

  ```javascript
  // Navigate to a URL
  await $page.goto('https://example.com');

  // Get page title and content
  const title = await $page.title();
  const content = await $page.textContent('body');

  console.log('Page title:', title);

  // Return results
  return [{
      json: { 
          title,
          content,
          url: $page.url()
      }
  }];
  ```

  #### Web Scraping with Selectors

  ```javascript
  await $page.goto('https://news.ycombinator.com');

  // Scrape all story titles
  const stories = await $page.$$eval('.titleline > a', elements => 
      elements.map(el => ({
          title: el.textContent,
          url: el.href
      }))
  );

  console.log(`Found ${stories.length} stories`);

  return stories.map(story => ({ json: story }));
  ```

  #### Form Automation

  ```javascript
  await $page.goto('https://example.com/login');

  // Fill form fields
  await $page.fill('#username', 'myuser');
  await $page.fill('#password', 'mypass');

  // Click submit button
  await $page.click('button[type="submit"]');

  // Wait for navigation
  await $page.waitForNavigation();

  console.log('Logged in successfully');

  return [{
      json: {
          success: true,
          finalUrl: $page.url()
      }
  }];
  ```

  #### Taking Screenshots as Binary Data

  ```javascript
  await $page.goto('https://www.google.com');

  // Take screenshot
  const screenshot = await $page.screenshot({ 
      type: 'png',
      fullPage: true 
  });

  // Prepare binary data
  const binaryData = await $helpers.prepareBinaryData(
      Buffer.from(screenshot),
      'screenshot.png',
      'image/png'
  );

  return [{
      json: {
          url: $page.url(),
          timestamp: new Date().toISOString()
      },
      binary: {
          screenshot: binaryData
      }
  }];
  ```

  #### Storing and Reusing Cookies

  **Script 1 - Login and Save Cookies**

  ```javascript
  await $page.goto('https://www.example.com/login');

  // Perform login
  await $page.fill('#login-username', 'user');
  await $page.fill('#login-password', 'pass');
  await $page.click('#login-button');

  // Wait for login to complete
  await $page.waitForNavigation();

  // Get browser context and save cookies
  const context = $page.context();
  const cookies = await context.cookies();

  console.log('Login successful, cookies saved');

  return [{
      json: { 
          cookies,
          loginSuccess: true
      }
  }];
  ```

  **Script 2 - Restore Cookies and Access Protected Page**

  ```javascript
  const { cookies } = $input.first().json;

  // Create new context with saved cookies
  const context = $page.context();
  await context.addCookies(cookies);

  // Navigate to authenticated page
  await $page.goto('https://example.com/protected-page');

  // Perform authenticated operations
  const data = await $page.textContent('.protected-content');

  console.log('Accessed protected page successfully');

  return [{
      json: { 
          data,
          authenticated: true
      }
  }];
  ```

  #### Advanced: Multiple Operations

  ```javascript
  await $page.goto('https://example.com/products');

  // Wait for products to load
  await $page.waitForSelector('.product-item');

  // Get all product data
  const products = await $page.$$eval('.product-item', items =>
      items.map(item => ({
          name: item.querySelector('.product-name')?.textContent,
          price: item.querySelector('.product-price')?.textContent,
          image: item.querySelector('img')?.src
      }))
  );

  // Take a screenshot
  const screenshot = await $page.screenshot({ type: 'png' });
  const screenshotBinary = await $helpers.prepareBinaryData(
      Buffer.from(screenshot),
      'products.png',
      'image/png'
  );

  console.log(`Scraped ${products.length} products`);

  return [{
      json: { 
          products,
          scrapedAt: new Date().toISOString(),
          totalProducts: products.length
      },
      binary: {
          screenshot: screenshotBinary
      }
  }];
  ```

  #### Using XPath Selectors

  ```javascript
  await $page.goto('https://example.com');

  // Use XPath to find elements
  const button = await $page.locator('xpath=//button[contains(text(), "Submit")]');
  await button.click();

  // XPath for complex selections
  const items = await $page.locator('xpath=//div[@class="item" and @data-active="true"]').all();
  const itemTexts = await Promise.all(items.map(item => item.textContent()));

  console.log(`Found ${itemTexts.length} active items`);

  return [{
      json: {
          activeItems: itemTexts
      }
  }];
  ```

  #### Error Handling

  ```javascript
  try {
      await $page.goto('https://example.com');
      
      // Try to find element with timeout
      const element = await $page.waitForSelector('.my-element', { 
          timeout: 5000 
      });
      
      const text = await element.textContent();
      
      return [{
          json: { 
              success: true,
              text 
          }
      }];
  } catch (error) {
      console.error('Error occurred:', error.message);
      
      return [{
          json: {
              success: false,
              error: error.message
          }
      }];
  }
  ```

  #### Working with Multiple Pages

  ```javascript
  // Open a new page
  const newPage = await $browser.newPage();
  await newPage.goto('https://example.com/page2');

  // Work with both pages
  const page1Title = await $page.title();
  const page2Title = await newPage.title();

  console.log('Page 1:', page1Title);
  console.log('Page 2:', page2Title);

  // Close the new page
  await newPage.close();

  return [{
      json: {
          page1Title,
          page2Title
      }
  }];
  ```

  #### Generating PDFs

  ```javascript
  await $page.goto('https://example.com');

  // Generate PDF
  const pdf = await $page.pdf({
      format: 'A4',
      printBackground: true,
      margin: {
          top: '20px',
          right: '20px',
          bottom: '20px',
          left: '20px'
      }
  });

  // Prepare binary data
  const binaryData = await $helpers.prepareBinaryData(
      Buffer.from(pdf),
      'document.pdf',
      'application/pdf'
  );

  return [{
      json: {
          url: $page.url(),
          timestamp: new Date().toISOString()
      },
      binary: {
          pdf: binaryData
      }
  }];
  ```

  #### Waiting for Dynamic Content

  ```javascript
  await $page.goto('https://example.com');

  // Wait for network to be idle
  await $page.waitForLoadState('networkidle');

  // Wait for specific element to appear
  await $page.waitForSelector('.dynamic-content', { timeout: 10000 });

  // Wait for element to be visible
  await $page.locator('.modal').waitFor({ state: 'visible' });

  // Extract data after everything has loaded
  const content = await $page.textContent('.dynamic-content');

  return [{
      json: { content }
  }];
  ```

  #### Handling File Downloads

  ```javascript
  await $page.goto('https://example.com/downloads');

  // Start waiting for download before clicking
  const downloadPromise = $page.waitForEvent('download');
  await $page.click('#download-button');

  const download = await downloadPromise;

  // Get download details
  const fileName = download.suggestedFilename();
  const downloadPath = await download.path();

  console.log(`Downloaded: ${fileName}`);

  return [{
      json: {
          fileName,
          downloadPath,
          success: true
      }
  }];
  ```

  ### Custom Script Tips

  1. **Always return an array**: Your script must return an array of objects like `return [{ json: {...} }];`
  2. **Use console.log()**: Debug by logging to the console - output appears in n8n UI during manual execution
  3. **Handle errors**: Use try-catch for robust scripts
  4. **Binary data**: Use `$helpers.prepareBinaryData()` for images, PDFs, or other files
  5. **Async/await**: All Playwright operations are async, always use `await`
  6. **Access input data**: Use `$json` or `$input` to access data from previous nodes
  7. **Browser cleanup**: The browser is automatically closed after script execution

  ## Compatibility

  - Requires n8n version 1.0.0 or later
  - Tested with Playwright version 1.49.0
  - Supports Windows, macOS, and Linux

  ### System Requirements

  - Node.js 18.10 or later
  - Approximately 1GB disk space for browser binaries
  - Additional system dependencies may be required for browser automation

  ## Resources

  - [n8n community nodes documentation](https://docs.n8n.io/integrations/community-nodes/)
  - [Playwright documentation](https://playwright.dev/docs/intro)
  - [Playwright API Reference](https://playwright.dev/docs/api/class-playwright)

  ## Version history

  ### 0.3.0

  - Added **Run Custom Script** operation with full Playwright API access
  - Added **XPath selector** support for Get Text, Click Element, and Fill Form operations
  - Added sandboxed JavaScript execution environment
  - Improved error handling and user feedback
  - Fixed navigate operation to return page content properly

  ### 0.2.*

  - Added selector-based operations (getText, clickElement, fillForm)
  - Improved browser binary installation process
  - Bug fixes and performance improvements

  ### 0.1.*

  - Initial release
  - Basic browser automation operations
  - Support for Chromium, Firefox, and WebKit
  - Screenshot and navigation capabilities

  ## Troubleshooting

  ### Browsers Not Installed

  If browsers are not installed correctly:

  1. Clean the installation:

  ```bash
  rm -rf ~/.cache/ms-playwright
  # or for Windows:
  rmdir /s /q %USERPROFILE%\AppData\Local\ms-playwright
  ```

  2. Rebuild the package:

  ```bash
  pnpm rebuild n8n-nodes-playwright
  ```

  ### Custom Script Errors

  If your custom script fails:

  1. Check that you're returning an array: `return [{ json: {...} }];`
  2. Use `console.log()` to debug and see output in n8n UI
  3. Wrap code in try-catch blocks for better error handling
  4. Verify all Playwright operations use `await`

  ### Selector Not Found

  If elements can't be found:

  1. Try using XPath instead of CSS selector (or vice versa)
  2. Use `await $page.waitForSelector('selector')` to wait for elements
  3. Check if content is in an iframe: `await $page.frameLocator('iframe').locator('selector')`
  4. Verify the page has fully loaded: `await $page.waitForLoadState('networkidle')`

  ## License

  [MIT](https://github.com/n8n-io/n8n-nodes-starter/blob/master/LICENSE.md)

  ---

  ## Contributing

  Contributions are welcome! Please feel free to submit a Pull Request.

  ## Support

  If you encounter any issues or have questions:

  1. Check the [Troubleshooting](#troubleshooting) section
  2. Review the [Playwright documentation](https://playwright.dev/docs/intro)
  3. Open an issue on [GitHub](https://github.com/toema/n8n-playwright/issues)

  ## Author

  **Mohamed Toema**  
  Email: m.toema20@gmail.com  
  GitHub: [@toema](https://github.com/toema)

ai_documentation_summary:
  {"purpose":"Automates browser actions in n8n workflows using Playwright for tasks like navigation, data extraction, form filling, and screenshot capture.","capabilities":["Navigate to URLs and retrieve page content","Take full-page or viewport screenshots (including Base64 output)","Extract text from elements using CSS selectors or XPath","Click elements using CSS selectors or XPath","Fill form fields using CSS selectors or XPath","Execute custom JavaScript with full Playwright API access","Support multiple browsers (Chromium, Firefox, WebKit)","Configure headless mode and slow motion","Handle binary data output","Manage cookies for session persistence"],"authentication":"None","commonUseCases":["Web scraping and data extraction","Form automation and login workflows","Screenshot generation for reports","Browser-based testing within n8n","Automated data collection from websites"],"limitations":["Requires approximately 1GB of disk space for browser binaries","Manual browser setup may be needed if not automatic","Custom scripts require JavaScript knowledge"],"relatedNodes":["Code","HTTP Request","Binary Data"]}


node_type: @bitovi/n8n-nodes-confluence.confluence
package_name: @bitovi/n8n-nodes-confluence
display_name: confluence
description: N8N node to connect to Confluence
category: Community
development_style: declarative
version: 0.1.6
properties_schema: []
operations: []
credentials_required: []
updated_at: 2026-04-16 09:43:37
author_name: bitovi-os
author_github_url: git+https://github.com/bitovi/n8n-nodes-confluence.git
npm_package_name: @bitovi/n8n-nodes-confluence
npm_version: 0.1.6
community_fetched_at: 2026-04-16T09:43:37.371Z
ai_summary_generated_at: 2026-03-25 22:47:20
npm_readme:
  ~# @bitovi/n8n-nodes-confluence

  This is an n8n community node. It lets you use Atlassian Confluence in your n8n workflows.

  Confluence is a collaborative workspace and documentation platform by Atlassian, used for creating, organizing, and sharing content with your team.

  [n8n](https://n8n.io/) is a [fair-code licensed](https://docs.n8n.io/reference/license/) workflow automation platform.

  [Installation](#installation)  
  [Operations](#operations)  
  [Credentials](#credentials)  
  [Compatibility](#compatibility)  
  [Usage](#usage)  
  [Resources](#resources)  
  [Version history](#version-history)  

  ## Installation

  Follow the [installation guide](https://docs.n8n.io/integrations/community-nodes/installation/) in the n8n community nodes documentation.

  - Make sure to allow community nodes with `N8N_COMMUNITY_PACKAGES_ENABLED=true`
  - Once logged in to your N8N web UI, go to `/settings/community-nodes` and type `@bitovi/n8n-nodes-confluence`

  ## Operations

  - **Get Spaces**: List Confluence spaces.
  - **Get Pages in Space**: List pages within a space.
  - **Custom API call**: Use Confluence's REST API.

  ## Credentials

  This node requires authentication with Atlassian Confluence.

  - **Domain**: Your Atlassian site URL (e.g., `https://your-domain.atlassian.net`).
  - **User Name**: Your Atlassian account email.
  - **API Key**: Generate an API token from your Atlassian account ([API tokens](https://id.atlassian.com/manage-profile/security/api-tokens)).

  ## Compatibility

  - Node version: 1
  - Tested with latest n8n version (please update as needed)

  ## Usage

  This node provides extensive filtering and customization options for retrieving Confluence data:

  ### Basic Operations
  - **Get Spaces**: Retrieve all spaces or filter by specific space names using comma-separated values
  - **Get Pages in Space**: List pages within a specific space using the Space ID

  ### Filtering Options
  - **Title**: Filter pages by exact title match
  - **Status**: Choose page status:
    - `current` (default) - Active pages
    - `archived` - Archived pages
    - `deleted` - Deleted pages
    - `trashed` - Trashed pages

  ### Content Format Options
  - **Body Format**: Control how page content is returned:
    - `storage` (default) - Confluence's internal storage format
    - `atlas_doc_format` - Atlas document format for modern editing

  ### Organization Options
  - **Depth**: Control the hierarchy level of pages returned:
    - `all` (default) - All pages regardless of hierarchy level
    - `root` - Only top-level pages

  - **Sort**: Order results by various criteria:
    - `modified-date` (descending, default) - Most recently modified first
    - `created-date` - Creation date (ascending/descending)
    - `title` - Alphabetical by title (ascending/descending)
    - `id` - By page ID (ascending/descending)

  ### Pagination
  - **Return All**: Toggle to get all results or limit the number
  - **Limit**: Set maximum number of results when not returning all (default: 50)
  - Pagination is automatically handled for large result sets

  ## Resources

  * [n8n community nodes documentation](https://docs.n8n.io/integrations/community-nodes/)
  * [Atlassian Confluence REST API documentation](https://developer.atlassian.com/cloud/confluence/rest/)

  ## Version history

  - v1.0.0: Initial release

  ## Need help or have questions?

  Need guidance on leveraging AI agents or N8N for your business? Our [AI Agents workshop](https://hubs.ly/Q02X-9Qq0) will equip you with the knowledge and tools necessary to implement successful and valuable agentic workflows.

  ## License

  [MIT](./LICENSE.md)
  ~

ai_documentation_summary:
  {"purpose":"Connects to Atlassian Confluence to retrieve spaces and pages within n8n workflows using REST API operations.","capabilities":["List Confluence spaces","List pages within a specific space","Custom API calls via Confluence REST API","Filter pages by title","Filter pages by status (current, archived, deleted, trashed)","Control content format (storage, atlas_doc_format)","Control page hierarchy depth (all, root)","Sort results by modified-date, created-date, title, or id","Pagination support with limit and return all options"],"authentication":"API Key required (Domain, User Name, API Token)","commonUseCases":["Automated documentation retrieval","Content migration between systems","Team workflow automation with Confluence data","Bulk page status management"],"limitations":["Community node (requires N8N_COMMUNITY_PACKAGES_ENABLED=true)","Requires manual API token generation in Atlassian account","Limited to Confluence REST API functionality"],"relatedNodes":["n8n HTTP Request node","n8n Community Nodes"]}


node_type: @bitovi/n8n-nodes-freshbooks.freshbooks
package_name: @bitovi/n8n-nodes-freshbooks
display_name: freshbooks
description: N8N node to connect to FreshBooks
category: Community
development_style: declarative
version: 0.1.1
properties_schema: []
operations: []
credentials_required: []
updated_at: 2026-04-16 09:43:37
author_name: bitovi-os
author_github_url: git+https://github.com/bitovi/n8n-nodes-freshbooks.git
npm_package_name: @bitovi/n8n-nodes-freshbooks
npm_version: 0.1.1
community_fetched_at: 2026-04-16T09:43:37.372Z
ai_summary_generated_at: 2026-03-25 22:47:20
npm_readme:
  # @bitovi/n8n-nodes-freshbooks

  This is an n8n community node. It lets you use FreshBooks in your n8n workflows.

  FreshBooks is a cloud-based accounting software designed for small businesses and freelancers, providing tools for invoicing, time tracking, expense management, and financial reporting.

  [n8n](https://n8n.io/) is a [fair-code licensed](https://docs.n8n.io/reference/license/) workflow automation platform.

  [Installation](#installation)  
  [Operations](#operations)  
  [Credentials](#credentials)  
  [Compatibility](#compatibility)  
  [Usage](#usage)  
  [Resources](#resources)  
  [Version history](#version-history)  

  ## Installation

  Follow the [installation guide](https://docs.n8n.io/integrations/community-nodes/installation/) in the n8n community nodes documentation.

  - Make sure to allow community nodes with `N8N_COMMUNITY_PACKAGES_ENABLED=true`
  - Once logged in to your N8N web UI, go to `/settings/community-nodes` and type `@bitovi/n8n-nodes-freshbooks`

  ## Operations

  ### Clients

  - **List Clients**: Retrieve all clients from your FreshBooks account

  ### Projects

  - **List Projects**: Get all projects for specified clients

  ### Services

  - **List Services**: Get available services for a specific project

  ### Time Tracking

  - **List Time Entries**: Retrieve time entries from your FreshBooks account
  - **Get Time Entry**: Retrieve a specific time entry by ID
  - **Create Time Entry**: Add a new time entry with client, project, service, note, date, and duration
  - **Update Time Entry**: Modify an existing time entry
  - **Delete Time Entry**: Remove a time entry

  ### User

  - **Get User Info**: Retrieve current user information

  ## Credentials

  This node requires OAuth2 authentication with FreshBooks.

  - **Client ID**: Your FreshBooks OAuth2 client ID from your app registration
  - **Client Secret**: Your FreshBooks OAuth2 client secret from your app registration  
  - **Authorization URL**: `https://my.freshbooks.com/service/auth/oauth/authorize`

  To set up OAuth2 credentials:

  1. Register your application in the FreshBooks Developer Portal
  2. Configure the redirect URI in your FreshBooks app settings
  3. Use the provided Client ID and Client Secret in your n8n credentials

  ## Compatibility

  - Node version: 1
  - Tested with latest n8n version

  ## Usage

  This node provides comprehensive access to FreshBooks functionality for accounting and time tracking:

  ### Time Tracking Operations

  #### Creating Time Entries

  - **Client ID**: Select the client for billing
  - **Project ID**: Associate with specific project
  - **Service ID**: Categorize the type of work performed
  - **Note**: Detailed description of work performed
  - **Date**: When the work was performed
  - **Duration**: Time spent in seconds (default: 28800 = 8 hours)
  - **Is Logged**: Whether the entry is marked as logged (default: true)

  #### Managing Time Entries

  - List all time entries with pagination support
  - Get specific time entries by ID
  - Update existing entries with new information
  - Delete time entries when needed

  ### Filtering and Options

  #### Client Operations

  - Filter by visibility state (active/archived)
  - Sort by various criteria (updated date, created date, etc.)

  #### Project Operations

  - Filter projects by specific client IDs
  - Show only active projects
  - Exclude completed projects from results

  ### Pagination Support

  - **Return All**: Get all results or limit the number returned
  - **Limit**: Set maximum number of results (default: 50)
  - Automatic pagination handling for large datasets

  ### User Information

  - Retrieve current authenticated user details
  - Access business and account information

  ## Resources

  - [n8n community nodes documentation](https://docs.n8n.io/integrations/community-nodes/)
  - [FreshBooks API documentation](https://www.freshbooks.com/api)
  - [FreshBooks Developer Portal](https://www.freshbooks.com/developers)

  ## Version history

  - v0.1.0: Initial release
    - Client, Project, Service, Time Tracking, and User operations
    - Full CRUD support for time entries
    - OAuth2 authentication
    - Pagination support

  ## Need help or have questions?

  Need guidance on leveraging AI agents or N8N for your business? Our [AI Agents workshop](https://hubs.ly/Q02X-9Qq0) will equip you with the knowledge and tools necessary to implement successful and valuable agentic workflows.

  ## License

  [MIT](./LICENSE.md)

ai_documentation_summary:
  {"purpose":"Connects n8n workflows to FreshBooks for accounting and time tracking operations, including client management, project tracking, service listing, and time entry CRUD.","capabilities":["List clients with filtering and sorting","List projects for specific clients","List available services for projects","Retrieve current user information","Create time entries with client, project, service, note, date, and duration","Update existing time entries","Delete time entries","Retrieve specific time entries by ID","List time entries with pagination support","Filter clients by visibility state (active/archived)"],"authentication":"OAuth2","commonUseCases":["Automating time tracking for freelancers","Generating invoices from FreshBooks data","Syncing project details between n8n and FreshBooks","Tracking billable hours automatically"],"limitations":["Community node (requires enabling in n8n settings)","Requires FreshBooks OAuth2 app registration before use"],"relatedNodes":["n8n HTTP Request","n8n Webhook","n8n Spreadsheet"]}


node_type: n8n-nodes-rifad-appsheet.rifadappsheet
package_name: n8n-nodes-rifad-appsheet
display_name: rifadappsheet
description: An n8n community node for interacting with the AppSheet API, including an AI Agent tool node
category: Community
development_style: declarative
version: 0.5.6
properties_schema: []
operations: []
credentials_required: []
updated_at: 2026-04-16 09:43:37
author_name: rifadm817
author_github_url: git+https://github.com/rifadm817/n8n-nodes-rifad-appsheet.git
npm_package_name: n8n-nodes-rifad-appsheet
npm_version: 0.5.6
community_fetched_at: 2026-04-16T09:43:37.373Z
npm_readme:
  # n8n-nodes-rifad-appsheet

  ☕️ [Support this project on Buy Me A Coffee!](https://buymeacoffee.com/rifadm817)

  Welcome to **n8n-nodes-rifad-appsheet** – your friendly bridge between AppSheet and n8n!  
  No more boring, hardcoded API calls. With our node, you can effortlessly manage your AppSheet table records by creating, reading, updating, deleting, or even invoking custom actions—all through an intuitive, no-code workflow automation tool.

  ## Features

  - **Create Record:** Add one or more new records to an AppSheet table.
  - **Read Records:** Retrieve records using a selector expression or by specifying key fields.
  - **Update Record:** Update existing records by providing key fields and the new field values.
  - **Delete Record:** Delete records by specifying key fields.
  - **Invoke Action:** Invoke a custom AppSheet action on one or more rows.

  ## Install on n8n Cloud

  If you use the cloud version of n8n (n8n.io), installing our node is a piece of cake. Follow these steps:

  1. **Log in to Your n8n.io Account:**  
     Open your browser and log in at [n8n.io](https://n8n.io).

  2. **Navigate to Settings:**  
     In the n8n editor, click your Profile → Settings icon.

  3. **Go to Community Nodes:**  
     Select **Community Nodes** from the Settings menu. You’ll be able to search for and install custom nodes there.

  4. **Search for `n8n-nodes-rifad-appsheet`:**  
     Type the package name in the search bar. When it appears, click **Install**.

  5. **Add the AppSheet Node to Your Workflow:**  
     Once installed, add the AppSheet node to your workflow, configure it with your AppSheet API credentials, and start automating without hardcoding API calls.

  ## Usage

  Simply configure the node with your AppSheet API credentials and choose an operation (create, read, update, delete, or invoke). Each operation requires you to provide the necessary parameters as JSON. For example, to add a record, supply a JSON array of objects (each object representing a record with the required key fields).


  Happy Automating!


node_type: n8n-nodes-asaas-v2.asaasv2
package_name: n8n-nodes-asaas-v2
display_name: asaasv2
description: Nó n8n para integração com a API do Asaas
category: Community
development_style: declarative
version: 1.0.15
properties_schema: []
operations: []
credentials_required: []
updated_at: 2026-04-16 09:43:37
author_name: degoisrs
author_github_url: git+https://github.com/analixbi/n8n-nodes-asaas-v2.git
npm_package_name: n8n-nodes-asaas-v2
npm_version: 1.0.15
community_fetched_at: 2026-04-16T09:43:37.374Z
ai_summary_generated_at: 2026-03-25 22:47:20
npm_readme:
  # n8n-nodes-asaas-v2

  Este é um nó não oficial do n8n para integração com a API do Asaas v3.

  ## Sobre a Analix Business Intelligence

  A Analix Business Intelligence é uma empresa especializada em soluções tecnológicas para negócios, oferecendo:

  - Desenvolvimento de agentes de atendimento para redes sociais com IA
  - Sistemas de notificação automático para WooCommerce
  - Sistema de atendimento multi atendente
  - Desenvolvimento de sites WordPress com WooCommerce para venda

  ## Contato

  - Website: [analixbi.com.br](https://analixbi.com.br)
  - Email: contato@analixbi.com.br
  - Telefone: +55 (54) 99135-7745

  ## Recursos

  - Clientes
    - Criar
    - Listar
    - Buscar
    - Atualizar
    - Remover

  - Pagamentos
    - Criar
    - Listar
    - Buscar
    - Atualizar
    - Remover

  - Assinaturas
    - Criar
    - Listar
    - Buscar
    - Atualizar
    - Remover

  - Links de Pagamento
    - Criar
    - Listar
    - Buscar
    - Atualizar
    - Remover

  - PIX
    - Criar
    - Listar
    - Buscar
    - Remover

  ## Instalação

  ```bash
  npm install n8n-nodes-asaas-v2
  ```

  ## Configuração

  1. Acesse [Asaas](https://www.asaas.com)
  2. Faça login na sua conta
  3. Vá em Configurações > API
  4. Gere uma nova API Key
  5. Configure no n8n:
     - Nome: Asaas API
     - API Key: sua_api_key
     - Ambiente: Produção ou Sandbox

  ## Ambiente Sandbox

  Para testar sem custos reais, use o ambiente sandbox:

  - API Key de sandbox
  - Dados fictícios seguros
  - Sem cobranças reais

  ## Suporte

  Para suporte técnico:

  - Email: contato@analixbi.com.br
  - Telefone: +55 (54) 99135-7745
  - Website: [analixbi.com.br](https://analixbi.com.br)

  ## Licença

  MIT 

ai_documentation_summary:
  {"purpose":"An unofficial n8n node for integrating with the Asaas v3 API to manage financial operations like clients, payments, subscriptions, and PIX.","capabilities":["Create clients","List clients","Search clients","Update clients","Delete clients","Create payments","List payments","Search payments","Update payments","Delete payments"],"authentication":"API Key required","commonUseCases":["Automating client management in Brazilian businesses","Processing and tracking payments via Asaas","Managing subscription billing cycles","Handling PIX payments for instant transfers","Integrating Asaas API into n8n workflows for data processing"],"limitations":["Unofficial node (not maintained by Asaas or n8n core)","Support depends on the third-party developer (Analix Business Intelligence)"],"relatedNodes":["n8n-nodes-base.httpRequest","n8n-nodes-base.code"]}


node_type: n8n-nodes-llamacloud.llamacloud
package_name: n8n-nodes-llamacloud
display_name: llamacloud
description: LlamaCloud integration with n8n
category: Community
development_style: declarative
version: 1.0.2
properties_schema: []
operations: []
credentials_required: []
updated_at: 2026-04-16 09:43:37
author_name: ibrahho
author_github_url: git+https://github.com/Hossam-Dev-AI/n8n-llamacloud.git
npm_package_name: n8n-nodes-llamacloud
npm_version: 1.0.2
community_fetched_at: 2026-04-16T09:43:37.375Z
ai_summary_generated_at: 2026-03-25 22:47:20
npm_readme:
  # n8n LlamaCloud Nodes

  This repository contains custom n8n nodes for integrating with [LlamaCloud](https://cloud.llamaindex.ai/?utm_source=demo&utm_medium=n8n), providing powerful document processing and retrieval capabilities within your n8n workflows.

  ## 🚀 Features

  This package includes three custom nodes:

  ### 📄 **[LlamaParse](https://www.llamaindex.ai/llamaparse?utm_source=demo&utm_medium=n8n)**
  - Parse PDF files and extract their content in markdown format
  - Uses LlamaCloud's document parsing capabilities
  - Perfect for document preprocessing workflows

  ### 🔍 **[LlamaExtract](https://www.llamaindex.ai/llamaextract?utm_source=demo&utm_medium=n8n)** 
  - Extract structured data from files using LlamaCloud extraction agents
  - Get elegant, structured information from documents
  - Ideal for data extraction and analysis workflows

  ### 💬 **[LlamaCloud](https://www.llamaindex.ai/llamacloud?utm_source=demo&utm_medium=n8)**
  - Retrieve context from your LlamaCloud indexes
  - Chat with your indexed documents
  - Great for building RAG (Retrieval-Augmented Generation) applications

  ## 📋 Prerequisites

  Before using these nodes, you need:

  1. **Node.js and npm** (Minimum version Node 20)
  > You can find instructions on how to install both using 
  nvm (Node Version Manager) for Linux, Mac, and WSL [here](https://github.com/nvm-sh/nvm). For 
  Windows users, refer to Microsoft's guide to [Install NodeJS on Windows](https://docs.microsoft.com/en-us/windows/dev-environment/javascript/nodejs-on-windows).

  2. **n8n** installed globally
     ```bash
     npm install n8n -g
     ```

  3. **LlamaCloud API Key**
     - Sign up at [cloud.llamaindex.ai](https://cloud.llamaindex.ai/?utm_source=demo&utm_medium=n8n)
     - Get your API key from the dashboard

  ## 🛠️ Installation

  ### Option 1: Local Development (Recommended)

  1. **Clone this repository**
     ```bash
     git clone https://github.com/run-llama/n8n-llamacloud.git
     cd n8n-llamacloud
     ```

  2. **Install dependencies**
     ```bash
     npm install
     ```

  3. **Build the nodes and publish locally**
     ```bash
     npm run build
     npm link
     ```

  4. **Link to n8n custom nodes directory**
     ```bash
     # Create custom nodes directory if it doesn't exist
     mkdir -p ~/.n8n/custom
     npm link n8n-llamacloud
     ```

  5. **Restart n8n**
     ```bash
     n8n stop
     n8n start
     ```

  ### Option 2: Global Installation

  1. **Install globally**
     ```bash
     npm install -g n8n-llamacloud
     npm link
     ```

  2. **Restart n8n**
     ```bash
     n8n stop
     n8n start
     ```

  ## 🔧 Setup

  ### 1. Configure LlamaCloud Credentials

  1. Open n8n in your browser (usually `http://localhost:5678`)
  2. Go to **Settings** → **Credentials**
  3. Click **Add Credential**
  4. Search for **"LlamaCloud API Key"**
  5. Enter your LlamaCloud API key 
  6. Test the connection and save

  ### 2. Create LlamaCloud Indexes (for LlamaCloud node)

  1. Go to [cloud.llamaindex.ai](https://cloud.llamaindex.ai/?utm_source=demo&utm_medium=n8n)
  2. Create a new project
  3. Upload documents to create an index
  4. Note the index name for use in the LlamaCloud node

  ## 📚 Resources
  - [LlamaCloud Documentation](https://docs.cloud.llamaindex.ai/utm_source=demo&utm_medium=n8n)
  - [LlamaIndex Documentation](https://docs.llamaindex.ai/utm_source=demo&utm_medium=n8n)
  - [n8n Documentation](https://docs.n8n.io/)
  - [n8n Community](https://community.n8n.io/)


  ## 📖 Usage Examples

  ### Example 1: Document Processing Pipeline

  ```mermaid
  graph LR
      A[PDF File] --> B[LlamaParse]
      B --> C[LlamaExtract]
      C --> D[Structured Data]
  ```

  **Workflow:**
  1. **LlamaParse** node: Parse a PDF file to markdown
  2. **LlamaExtract** node: Extract structured data using an extraction agent
  3. Use the structured data in subsequent nodes

  ### Example 2: RAG Chat Application

  ```mermaid
  graph LR
      A[User Query] --> B[LlamaCloud]
      B --> C[Retrieved Context]
      C --> D[AI Response]
  ```

  **Workflow:**
  1. **HTTP Request** node: Receive user query
  2. **LlamaCloud** node: Retrieve relevant context from your index
  3. **OpenAI** node: Generate response using the retrieved context

  ### Example 3: Document Analysis

  ```mermaid
  graph LR
      A[Document] --> B[LlamaParse]
      B --> C[LlamaExtract]
      C --> D[Analysis Results]
  ```

  **Workflow:**
  1. **LlamaParse** node: Convert document to markdown
  2. **LlamaExtract** node: Extract specific information (e.g., dates, amounts, entities)
  3. **Code** node: Process and analyze the extracted data

  ## 🔍 Node Details

  ### LlamaParse Node

  **Purpose:** Parse PDF files and extract content in markdown format

  **Parameters:**
  - **File Path** (required): Path to the PDF file to parse
    - Example: `/Users/username/Documents/document.pdf`

  **Output:** Markdown content of the parsed document

  ### LlamaExtract Node

  **Purpose:** Extract structured data from files using LlamaCloud extraction agents

  **Parameters:**
  - **Agent ID** (required): The ID of your LlamaCloud extraction agent
  - **File Path** (required): Path to the file to extract data from

  **Output:** Structured data based on your extraction agent's configuration

  ### LlamaCloud Node

  **Purpose:** Retrieve context from your LlamaCloud indexes

  **Parameters:**
  - **Index Name** (required): Name of your LlamaCloud index
  - **Chat Input** (from previous node): The query to search for in your index

  **Output:** Retrieved context from your index

ai_documentation_summary:
  {"purpose":"This n8n node package integrates with LlamaCloud to provide document processing, structured data extraction, and retrieval capabilities for building RAG applications.","capabilities":["Parse PDF files and extract content in markdown format","Extract structured data from files using LlamaCloud extraction agents","Retrieve context from LlamaCloud indexes for chat applications","Support document preprocessing workflows","Enable Retrieval-Augmented Generation (RAG) workflows"],"authentication":"LlamaCloud API Key","commonUseCases":["Document preprocessing pipelines","Data extraction and analysis from documents","RAG chat applications","Document analysis workflows"],"limitations":["Requires Node.js version 20 or higher","Requires n8n installed globally","Requires local development build or global installation","Requires manual setup of LlamaCloud indexes"],"relatedNodes":["LlamaParse","LlamaExtract","LlamaCloud","HTTP Request","OpenAI"]}


node_type: n8n-nodes-wecom.wecom
package_name: n8n-nodes-wecom
display_name: wecom
category: Community
development_style: declarative
version: 0.4.9
properties_schema: []
operations: []
credentials_required: []
updated_at: 2026-04-16 09:43:37
author_name: funcodingdev
author_github_url: git+https://github.com/funcodingdev/n8n-nodes-wecom.git
npm_package_name: n8n-nodes-wecom
npm_version: 0.4.9
community_fetched_at: 2026-04-16T09:43:37.376Z
description:
  Complete n8n integration for WeCom (企业微信/WeChat Work). Send messages, manage contacts, departments, customer relations, meetings, documents, email, calendar, approvals, and more. Full-featured enterprise WeChat automation node.

npm_readme:
  # n8n-nodes-wecom

  [![npm version](https://img.shields.io/npm/v/n8n-nodes-wecom.svg?style=flat-square)](https://www.npmjs.com/package/n8n-nodes-wecom) [![GitHub release](https://img.shields.io/github/v/release/funcodingdev/n8n-nodes-wecom?include_prereleases&style=flat-square)](https://github.com/funcodingdev/n8n-nodes-wecom/releases)

  这是一个 n8n 社区节点，让你可以在 [n8n](https://n8n.io/) 工作流中使用企业微信（WeChat Work）API。

  ## ⚠️ 重要提示

  > **关于版本更新与稳定性**
  >
  > 本插件的设计初衷是提供**简单、稳定**的企业微信集成体验。我们以 N8N 官方原生节点（如 Telegram、Notion等）为标准，力求交互逻辑清晰直观。
  >
  > **开发原则：**
  > 我们会审慎评估每一次代码变更，尽量维持现有节点结构和参数的稳定性，避免对生产环境造成不必要的影响。
  >
  > **注意事项：**
  > 在极少数情况下，为了修复重大缺陷或适配企业微信 API 的关键变更，可能会引入必要的调整。
  >
  > **建议：**
  > 生产环境更新前，请查看 [Release 日志](https://github.com/funcodingdev/n8n-nodes-wecom/releases)。如果涉及 Breaking Changes（破坏性变更），我们会显著标记。
  >
  > **文档说明：**
  > 本文档旨在概括插件支持的核心功能。由于企业微信接口众多且更新频繁，本文档可能无法覆盖所有参数细节。遇有疑问，请优先参考 [企业微信官方 API 文档](https://developer.work.weixin.qq.com/document/path/90664)。

  ## 🤝 交流与支持

  遇到问题或有功能建议？欢迎查阅 [企业微信官方文档](https://developer.work.weixin.qq.com/document/path/90664) 或加入我们的交流群。

  ### 💬 加入社区

  |                          方式 1：扫码直接入群                          |                     方式 2：联系作者邀请                     |
  | :--------------------------------------------------------------------: | :----------------------------------------------------------: |
  | <img src="./wechat_group_qrcode.jpg" width="200" alt="微信群二维码" /> | <img src="./wechat_qrcode.jpg" width="200" alt="作者微信" /> |
  |                                 (推荐)                                 |               若群码失效，请备注 **n8n** 拉你                |

  ### 参与贡献

  我们非常欢迎社区贡献！如果你发现了 bug、有新功能建议或想要改进代码：

  - **提交 Issue**：[GitHub Issues](https://github.com/funcodingdev/n8n-nodes-wecom/issues) - 报告问题或提出功能建议
  - **提交 Pull Request**：[GitHub Pull Requests](https://github.com/funcodingdev/n8n-nodes-wecom/pulls) - 贡献代码改进

  无论是代码贡献、文档改进还是功能建议，我们都非常感谢！

  ---

  ## 🧩 节点分类

  本插件按照企业微信官方文档的分类结构，提供以下节点：

  ### 1. 企业微信-基础

  包含企业微信的基础通信和管理功能：

  - **通讯录管理** - 成员、部门、标签管理
  - **应用消息** - 发送各类应用消息
  - **群聊会话** - 群聊管理和消息发送
  - **消息推送** - 群机器人 Webhook 推送
  - **企业互联** - 企业互联和上下游管理
  - **素材管理** - 素材上传和管理
  - **电子发票** - 电子发票查询和状态管理
  - **第三方应用授权** - 获取第三方应用凭证
  - **第三方应用接口调用许可** - 接口调用许可管理
  - **第三方应用收银台** - 第三方应用收银台
  - **第三方应用推广二维码** - 第三方应用推广二维码
  - **账号 ID** - 自建应用与第三方应用的对接

  ### 2. 企业微信-办公

  包含企业微信的协同办公功能：

  - **日程管理** - 日历和日程管理
  - **会议管理** - 会议预约、会议控制、录制管理
  - **直播管理** - 直播创建、观看、统计管理
  - **邮件管理** - 企业邮箱、邮件群组、公共邮箱
  - **文档管理** - 在线文档、表格、智能表格
  - **微盘管理** - 微盘空间和文件管理
  - **打卡管理** - 打卡规则、打卡记录、排班管理
  - **审批管理** - 审批模板、审批申请、假期管理
  - **汇报管理** - 汇报记录、汇报统计
  - **人事助手** - 员工花名册信息管理
  - **会议室管理** - 会议室和会议室预定管理
  - **紧急通知** - 语音电话等紧急通知

  ### 3. 企业微信-连接微信

  包含企业微信连接微信的功能：

  - **客户联系** - 客户管理、标签、继承、客户群、朋友圈、群发等
  - **微信客服** - 客服账号、接待人员、消息收发、统计管理
  - **家校应用** - 健康上报、上课直播、班级收款

  ### 4. 企业微信消息接收触发器

  接收企业微信的消息和事件推送（支持普通接收和被动回复两种模式）

  ### 5. 企业微信第三方应用指令回调触发器

  接收企业微信第三方应用的指令回调事件（授权、通讯录变更、ticket变化等）

  ## 🔒 隐私与安全

  **本插件完全基于企业微信官方 API 开发，直连企业微信服务器，不经过任何第三方服务器。**

  - ✅ **数据直连**：默认所有 API 请求直接发送到企业微信官方服务器 (`qyapi.weixin.qq.com`)
  - ✅ **API 代理**：支持配置自定义 API Base URL，适用于需要通过代理访问企业微信 API 的网络环境（默认直连）
  - ✅ **无数据缓存**：插件不存储、不缓存任何企业数据或用户信息
  - ✅ **无第三方依赖**：不依赖任何第三方数据服务或分析服务
  - ✅ **开源透明**：源代码完全开源，可随时审查和验证
  - ✅ **本地运行**：所有数据处理均在你的 n8n 实例中进行

  你的企业数据安全完全由你的 n8n 实例和企业微信官方平台保障。

  ## 📦 安装

  在 n8n 中通过社区节点管理界面搜索 `n8n-nodes-wecom` 进行安装，或使用命令行：

  ```bash
  npm install n8n-nodes-wecom
  ```

  详细安装指南请参考 [n8n 社区节点文档](https://docs.n8n.io/integrations/community-nodes/installation/)。

  ## 🔑 凭证配置

  ### 消息推送凭证（WebHook URL）

  **消息推送**功能用于通过群机器人 Webhook 发送消息到企业微信群聊

  #### 配置步骤

  1. 在企业微信群聊中，点击右上角"..."菜单
  2. 选择"群机器人" > "添加机器人"
  3. 创建一个机器人并复制 Webhook 地址
  4. 在 n8n 中配置"企业微信群机器人 Webhook"凭证，填入 Webhook 地址

  ### 获取企业微信请求凭证（消息发送、通讯录、素材管理等功能需要）

  1. 登录 [企业微信管理后台](https://work.weixin.qq.com/)
  2. 进入"我的企业" > "企业信息"，复制 **企业ID (CorpID)**
  3. 进入"应用管理" > 选择或创建一个应用
  4. 复制 **AgentId**（应用ID）
  5. 点击"查看Secret"，复制 **Secret**

  ### 获取企业微信消息接收凭证

  1. 登录 [企业微信管理后台](https://work.weixin.qq.com/)
  2. 进入"我的企业" > "企业信息"，复制 **企业ID (CorpID)**
  3. 进入"应用管理" > 选择或创建一个应用
  4. 启用 **API接收消息**，设置Token、EncodingAESKey
  5. 在 n8n 中创建"企业微信消息接收触发器"节点：
     - 配置凭证（企业ID、Token、EncodingAESKey）
     - **Path** 表示 Webhook URL 的路径，建议使用应用 ID
     - 保存节点后，查看生成的 Webhook URL（例如：`https://your-n8n.com/webhook/1000001`）
  6. 将 Webhook URL 填入企业微信后台的**接收消息服务器配置**中

  **重要提示**：

  - 企业微信每个应用只能配置一个接收消息 URL
  - 多个工作流可以使用同一个凭证（同一应用ID），它们会共享同一个 Webhook URL 接收消息
  - 不同应用请创建不同的凭证，使用不同的应用ID

  ### 获取企业微信第三方应用指令回调凭证

  1. 登录 [企业微信服务商后台](https://open.work.weixin.qq.com/)
  2. 进入"应用管理" > "第三方应用"，选择或创建一个第三方应用
  3. 复制 **第三方应用ID (SuiteID)**（以ww或wx开头）
  4. 在"应用详情" > "开发信息"中，设置**指令回调URL**，配置Token、EncodingAESKey
  5. 在 n8n 中创建"企业微信第三方应用指令回调触发器"节点：
     - 配置凭证（第三方应用ID、Token、EncodingAESKey）
     - **Path** 表示 Webhook URL 的路径，建议使用应用相关的唯一标识（例如：`suite/receive`）
     - 保存节点后，查看生成的 Webhook URL（例如：`https://your-n8n.com/webhook/suite/receive`）
  6. 将 Webhook URL 填入企业微信服务商后台的**指令回调URL**配置中

  **重要提示**：

  - 第三方应用的指令回调使用SuiteID作为receiveid（而不是CorpID）
  - 服务商收到推送后必须返回字符串 "success"，否则企业微信会把返回内容当作错误信息
  - 支持的事件类型：授权变更、通讯录变更、Suite Ticket推送、应用变更等

  ## ✨ 已实现功能

  以下功能按照企业微信官方文档分类组织：

  ---

  ## 一、基础功能（企业微信-基础 节点）

  ### 消息接收（触发器节点）

  > [官方文档：接收消息与事件](https://developer.work.weixin.qq.com/document/path/90238)

  **接收消息功能：**

  - ✅ [接收企业微信应用消息回调](https://developer.work.weixin.qq.com/document/path/90238)
  - ✅ [接收文本消息](https://developer.work.weixin.qq.com/document/path/90239)（包含 Content 字段）
  - ✅ [接收图片消息](https://developer.work.weixin.qq.com/document/path/90239)（包含 PicUrl、MediaId 字段）
  - ✅ [接收语音消息](https://developer.work.weixin.qq.com/document/path/90239)（包含 MediaId、Format 字段）
  - ✅ [接收视频消息](https://developer.work.weixin.qq.com/document/path/90239)（包含 MediaId、ThumbMediaId 字段）
  - ✅ [接收位置消息](https://developer.work.weixin.qq.com/document/path/90239)（包含 Location_X、Location_Y、Scale、Label、AppType 字段）
  - ✅ [接收链接消息](https://developer.work.weixin.qq.com/document/path/90239)（包含 Title、Description、Url、PicUrl 字段）
  - ✅ [接收事件推送](https://developer.work.weixin.qq.com/document/path/90240)（成员变更、部门变更等）
  - ✅ [接口许可失效通知](https://developer.work.weixin.qq.com/document/path/90600)（当许可账号失效的企业成员访问应用时触发）
  - ✅ URL 验证
  - ✅ 消息加解密
  - ✅ 签名验证

  **被动回复消息功能：**

  > [官方文档：被动回复消息](https://developer.work.weixin.qq.com/document/path/90241)

  使用「企业微信消息接收（被动回复）触发器」+ 「企业微信-基础」节点的「被动回复」功能实现：

  - ✅ [被动回复文本消息](https://developer.work.weixin.qq.com/document/path/90241)
  - ✅ [被动回复图片消息](https://developer.work.weixin.qq.com/document/path/90241)
  - ✅ [被动回复语音消息](https://developer.work.weixin.qq.com/document/path/90241)
  - ✅ [被动回复视频消息](https://developer.work.weixin.qq.com/document/path/90241)
  - ✅ [被动回复图文消息](https://developer.work.weixin.qq.com/document/path/90241)
  - ✅ [被动回复模板卡片更新消息](https://developer.work.weixin.qq.com/document/path/90241)
  - ✅ 自动加密和签名
  - ✅ 支持从工作流输出中读取回复内容

  **工作流配置示例：**

  ```
  [企业微信消息接收(被动回复)触发器] → [中间处理节点(可选)] → [企业微信-基础 (被动回复)]
  ```

  > ⚠️ **重要提示**：
  >
  > - 被动回复节点**必须是工作流的最后一个节点**
  > - 必须在**5秒内**返回响应，否则企业微信会认为请求失败
  > - 请确保工作流处理时间足够快

  **回调机制参考文档：**

  - [回调机制说明](https://developer.work.weixin.qq.com/document/path/92520)
  - [回调机制示例代码](https://developer.work.weixin.qq.com/document/path/92521)

  **第三方应用指令回调功能：**

  > [官方文档：第三方应用回调事件](https://developer.work.weixin.qq.com/document/path/91116)

  使用「企业微信第三方应用指令回调触发器」接收第三方应用的指令回调事件：

  - ✅ [接收授权成功通知](https://developer.work.weixin.qq.com/document/path/91118)
  - ✅ [接收变更授权通知](https://developer.work.weixin.qq.com/document/path/91119)
  - ✅ [接收取消授权通知](https://developer.work.weixin.qq.com/document/path/91120)
  - ✅ [接收Suite Ticket推送](https://developer.work.weixin.qq.com/document/path/91117)
  - ✅ [接收成员通知事件](https://developer.work.weixin.qq.com/document/path/91121)
  - ✅ [接收部门通知事件](https://developer.work.weixin.qq.com/document/path/91122)
  - ✅ [接收标签通知事件](https://developer.work.weixin.qq.com/document/path/91123)
  - ✅ [接收共享应用事件回调](https://developer.work.weixin.qq.com/document/path/91124)
  - ✅ [接收重置永久授权码通知](https://developer.work.weixin.qq.com/document/path/95437)
  - ✅ [接收应用管理员变更通知](https://developer.work.weixin.qq.com/document/path/91125)
  - ✅ [接收授权组织架构权限通知](https://developer.work.weixin.qq.com/document/path/91126)
  - ✅ [接收获客助手权限变更通知](https://developer.work.weixin.qq.com/document/path/91127)
  - ✅ [接收支付成功通知](https://developer.work.weixin.qq.com/document/path/90600)
  - ✅ [接收退款结果通知](https://developer.work.weixin.qq.com/document/path/90600)
  - ✅ [接收自动激活回调通知](https://developer.work.weixin.qq.com/document/path/90600)
  - ✅ [接收下单成功通知](https://developer.work.weixin.qq.com/document/path/90600)
  - ✅ [接收改单通知](https://developer.work.weixin.qq.com/document/path/90600)
  - ✅ [接收支付成功通知](https://developer.work.weixin.qq.com/document/path/90600)
  - ✅ [接收退款通知](https://developer.work.weixin.qq.com/document/path/90600)
  - ✅ [接收应用版本变更通知](https://developer.work.weixin.qq.com/document/path/90600)
  - ✅ [接收取消订单通知](https://developer.work.weixin.qq.com/document/path/90600)
  - ✅ [接收注册完成回调事件](https://developer.work.weixin.qq.com/document/path/90585)
  - ✅ [接收扫描推广二维码事件](https://developer.work.weixin.qq.com/document/path/98071)
  - ✅ URL 验证
  - ✅ 消息加解密（使用SuiteID作为receiveid）
  - ✅ 签名验证
  - ✅ 自动返回 "success" 响应（授权相关事件需在1000ms内响应）

  **重要提示**：

  - 第三方应用的指令回调使用SuiteID作为receiveid（而不是CorpID）
  - 服务商收到推送后必须返回字符串 "success"，否则企业微信会把返回内容当作错误信息
  - 授权相关事件（create_auth、change_auth、cancel_auth、reset_permanent_code）的响应必须在1000ms内完成
  - 收到取消授权事件后，应当确保删除该企业所有相关的数据

  ### 消息推送（群机器人）

  > [官方文档：消息推送配置说明](https://developer.work.weixin.qq.com/document/path/99110)

  - ✅ 发送文本消息
  - ✅ 发送 Markdown 消息
  - ✅ 发送 Markdown V2 消息
  - ✅ 发送图片消息
  - ✅ 发送图文消息
  - ✅ 发送文件消息
  - ✅ 发送语音消息
  - ✅ 发送模板卡片消息
    - 文本通知模板卡片
    - 图文展示模板卡片

  ### 应用消息发送

  > [官方文档：发送应用消息](https://developer.work.weixin.qq.com/document/path/90236)

  - ✅ 发送文本消息
  - ✅ 发送 Markdown 消息
  - ✅ 发送图片消息
  - ✅ 发送语音消息
  - ✅ 发送视频消息
  - ✅ 发送文件消息
  - ✅ 发送文本卡片消息
  - ✅ 发送图文消息（news）
  - ✅ 发送图文消息（mpnews）
  - ✅ 发送小程序通知消息
  - ✅ 发送任务卡片消息
  - ✅ 发送模板卡片消息
  - ✅ [发送学校通知](https://developer.work.weixin.qq.com/document/path/91609)（家校应用）
  - ✅ [撤回应用消息](https://developer.work.weixin.qq.com/document/path/94867)
  - ✅ [更新模板卡片消息](https://developer.work.weixin.qq.com/document/path/94888)

  ### 群聊会话

  > [官方文档：应用发送消息到群聊会话](https://developer.work.weixin.qq.com/document/path/90244)

  - ✅ [创建群聊会话](https://developer.work.weixin.qq.com/document/path/90245)
  - ✅ [获取群聊会话信息](https://developer.work.weixin.qq.com/document/path/98914)
  - ✅ [修改群聊会话](https://developer.work.weixin.qq.com/document/path/98913)
  - ✅ [发送消息到群聊](https://developer.work.weixin.qq.com/document/path/90248)
    - 发送文本消息到群聊（支持 `@群成员` / `@所有人`）
    - 发送图片消息到群聊
    - 发送文件消息到群聊
    - 发送 Markdown 消息到群聊
    - 发送图文消息到群聊

  ### 通讯录管理

  > [官方文档：通讯录管理](https://developer.work.weixin.qq.com/document/path/90193)

  #### 成员管理

  - ✅ [创建成员](https://developer.work.weixin.qq.com/document/path/90195)
  - ✅ [读取成员信息](https://developer.work.weixin.qq.com/document/path/90196)
  - ✅ [更新成员](https://developer.work.weixin.qq.com/document/path/90197)
  - ✅ [删除成员](https://developer.work.weixin.qq.com/document/path/90198)
  - ✅ [批量删除成员](https://developer.work.weixin.qq.com/document/path/90199)
  - ✅ [获取部门成员列表](https://developer.work.weixin.qq.com/document/path/90200)
  - ✅ [获取部门成员详情](https://developer.work.weixin.qq.com/document/path/90201)
  - ✅ [获取成员ID列表](https://developer.work.weixin.qq.com/document/path/96067)
  - ✅ [userid与openid互换](https://developer.work.weixin.qq.com/document/path/90202)
  - ✅ [登录二次验证](https://developer.work.weixin.qq.com/document/path/91623)
  - ✅ [邀请成员](https://developer.work.weixin.qq.com/document/path/90975)
  - ✅ [获取加入企业二维码](https://developer.work.weixin.qq.com/document/path/91714)
  - ✅ [手机号获取userid](https://developer.work.weixin.qq.com/document/path/95402)
  - ✅ [邮箱获取userid](https://developer.work.weixin.qq.com/document/path/95895)
  - ✅ [临时外部联系人ID转换](https://developer.work.weixin.qq.com/document/path/98729)

  #### 部门管理

  - ✅ [创建部门](https://developer.work.weixin.qq.com/document/path/90205)
  - ✅ [更新部门](https://developer.work.weixin.qq.com/document/path/90206)
  - ✅ [删除部门](https://developer.work.weixin.qq.com/document/path/90207)
  - ✅ [获取部门列表](https://developer.work.weixin.qq.com/document/path/90208)
  - ✅ [获取子部门ID列表](https://developer.work.weixin.qq.com/document/path/95350)
  - ✅ [获取单个部门详情](https://developer.work.weixin.qq.com/document/path/95351)

  #### 标签管理

  - ✅ [创建标签](https://developer.work.weixin.qq.com/document/path/90210)
  - ✅ [更新标签名字](https://developer.work.weixin.qq.com/document/path/90211)
  - ✅ [删除标签](https://developer.work.weixin.qq.com/document/path/90212)
  - ✅ [获取标签成员](https://developer.work.weixin.qq.com/document/path/90213)
  - ✅ [增加标签成员](https://developer.work.weixin.qq.com/document/path/90214)
  - ✅ [删除标签成员](https://developer.work.weixin.qq.com/document/path/90215)
  - ✅ [获取标签列表](https://developer.work.weixin.qq.com/document/path/90216)

  #### 账号ID转换

  > [官方文档：账号 ID](https://developer.work.weixin.qq.com/document/path/98728)

  - ✅ [用户ID转OpenID](https://developer.work.weixin.qq.com/document/path/90202)
  - ✅ [OpenID转用户ID](https://developer.work.weixin.qq.com/document/path/90202)
  - ✅ [临时外部联系人ID转换](https://developer.work.weixin.qq.com/document/path/98729)
  - ✅ [corpid转换（第三方应用）](https://developer.work.weixin.qq.com/document/path/95890)
  - ✅ [userid转换（第三方应用）](https://developer.work.weixin.qq.com/document/path/95890)
  - ✅ [external_userid转换（第三方应用）](https://developer.work.weixin.qq.com/document/path/95890)
  - ✅ [external_userid转换（客户群成员）](https://developer.work.weixin.qq.com/document/path/95890)
  - ✅ [unionid转换（第三方应用）](https://developer.work.weixin.qq.com/document/path/95890)
  - ✅ [external_userid查询pending_id（第三方应用）](https://developer.work.weixin.qq.com/document/path/95890)
  - ✅ [客户标签ID转换（第三方应用）](https://developer.work.weixin.qq.com/document/path/95890)
  - ✅ [微信客服ID转换（第三方应用）](https://developer.work.weixin.qq.com/document/path/95890)
  - ✅ [ID迁移完成状态设置（第三方应用）](https://developer.work.weixin.qq.com/document/path/95890)

  #### 异步导入接口

  > [官方文档：异步导入接口](https://developer.work.weixin.qq.com/document/path/90979)

  - ✅ [增量更新成员](https://developer.work.weixin.qq.com/document/path/90980)
  - ✅ [全量覆盖成员](https://developer.work.weixin.qq.com/document/path/90981)
  - ✅ [全量覆盖部门](https://developer.work.weixin.qq.com/document/path/90982)
  - ✅ [获取异步任务结果](https://developer.work.weixin.qq.com/document/path/90983)

  #### 异步导出接口

  > [官方文档：异步导出接口](https://developer.work.weixin.qq.com/document/path/94850)

  - ✅ [导出成员](https://developer.work.weixin.qq.com/document/path/94849)
  - ✅ [导出成员详情](https://developer.work.weixin.qq.com/document/path/94851)
  - ✅ [导出部门](https://developer.work.weixin.qq.com/document/path/94852)
  - ✅ [导出标签成员](https://developer.work.weixin.qq.com/document/path/94853)
  - ✅ [获取导出结果](https://developer.work.weixin.qq.com/document/path/94854)

  ### 素材管理

  > [官方文档：素材管理](https://developer.work.weixin.qq.com/document/path/91054)

  - ✅ [上传临时素材](https://developer.work.weixin.qq.com/document/path/90253)
  - ✅ [上传图片](https://developer.work.weixin.qq.com/document/path/90256)
  - ✅ [异步上传临时素材](https://developer.work.weixin.qq.com/document/path/96219)
  - ✅ [获取临时素材](https://developer.work.weixin.qq.com/document/path/90254)
  - ✅ [获取高清语音素材](https://developer.work.weixin.qq.com/document/path/90255)

  ### 企业互联

  > [官方文档：企业互联](https://developer.work.weixin.qq.com/document/path/93360)

  #### 企业互联基础接口

  - ✅ [获取应用共享信息](https://developer.work.weixin.qq.com/document/path/93403)
  - ✅ [获取下级/下游企业的access_token](https://developer.work.weixin.qq.com/document/path/93359)
  - ✅ [获取下级/下游企业小程序session](https://developer.work.weixin.qq.com/document/path/93355)

  #### 上下游基础接口

  > [官方文档：上下游](https://developer.work.weixin.qq.com/document/path/97213)

  - ✅ [获取应用共享信息](https://developer.work.weixin.qq.com/document/path/95813)
  - ✅ [获取下级/下游企业的access_token](https://developer.work.weixin.qq.com/document/path/95816)
  - ✅ [获取下级/下游企业小程序session](https://developer.work.weixin.qq.com/document/path/95817)
  - ✅ [上下游关联客户信息-已添加客户](https://developer.work.weixin.qq.com/document/path/95818)
  - ✅ [上下游关联客户信息-未添加客户](https://developer.work.weixin.qq.com/document/path/97357)

  #### 上下游通讯录管理

  - ✅ [获取上下游信息](https://developer.work.weixin.qq.com/document/path/95820)
  - ✅ [批量导入上下游联系人](https://developer.work.weixin.qq.com/document/path/95821)
  - ✅ [获取异步任务结果](https://developer.work.weixin.qq.com/document/path/95823)
  - ✅ [移除企业](https://developer.work.weixin.qq.com/document/path/95822)
  - ✅ [查询成员自定义id](https://developer.work.weixin.qq.com/document/path/97441)
  - ✅ [获取下级企业加入的上下游](https://developer.work.weixin.qq.com/document/path/97442)

  #### 上下游规则

  - ✅ [获取对接规则id列表](https://developer.work.weixin.qq.com/document/path/95631)
  - ✅ [删除对接规则](https://developer.work.weixin.qq.com/document/path/95632)
  - ✅ [获取对接规则详情](https://developer.work.weixin.qq.com/document/path/95633)
  - ✅ [新增对接规则](https://developer.work.weixin.qq.com/document/path/95634)
  - ✅ [更新对接规则](https://developer.work.weixin.qq.com/document/path/95635)

  ### 系统

  > [官方文档：获取企业微信服务器IP段](https://developer.work.weixin.qq.com/document/path/92520)

  - ✅ [获取企业微信接口IP段](https://developer.work.weixin.qq.com/document/path/92520)
  - ✅ [获取企业微信回调IP段](https://developer.work.weixin.qq.com/document/path/92521)

  ### 电子发票

  > [官方文档：电子发票](https://developer.work.weixin.qq.com/document/path/90283)

  - ✅ [查询电子发票](https://developer.work.weixin.qq.com/document/path/90284)
  - ✅ [更新发票状态](https://developer.work.weixin.qq.com/document/path/90285)
  - ✅ [批量更新发票状态](https://developer.work.weixin.qq.com/document/path/90286)
  - ✅ [批量查询电子发票](https://developer.work.weixin.qq.com/document/path/90287)

  ### 第三方应用授权

  > [官方文档：应用授权](https://developer.work.weixin.qq.com/document/path/90600)

  - ✅ [获取第三方应用凭证](https://developer.work.weixin.qq.com/document/path/90600)
  - ✅ [获取预授权码](https://developer.work.weixin.qq.com/document/path/90601)
  - ✅ [设置授权配置](https://developer.work.weixin.qq.com/document/path/90602)
  - ✅ [获取企业永久授权码](https://developer.work.weixin.qq.com/document/path/100776)
  - ✅ [获取企业授权信息](https://developer.work.weixin.qq.com/document/path/100779)
  - ✅ [获取企业凭证](https://developer.work.weixin.qq.com/document/path/90605)
  - ✅ [获取应用二维码](https://developer.work.weixin.qq.com/document/path/95430)
  - ✅ [明文corpid转换为加密corpid](https://developer.work.weixin.qq.com/document/path/95890)
  - ✅ [获取应用权限详情](https://developer.work.weixin.qq.com/document/path/99052)
  - ✅ [获取应用管理员列表](https://developer.work.weixin.qq.com/document/path/100073)
  - ✅ [获取订单列表](https://developer.work.weixin.qq.com/document/path/90600)
  - ✅ [获取订单详情](https://developer.work.weixin.qq.com/document/path/90600)
  - ✅ [延长试用期](https://developer.work.weixin.qq.com/document/path/90600)

  ### 第三方应用接口调用许可

  > [官方文档：接口调用许可](https://developer.work.weixin.qq.com/document/path/95652)

  - ✅ [下单购买账号](https://developer.work.weixin.qq.com/document/path/95644)
  - ✅ [下单续期账号](https://developer.work.weixin.qq.com/document/path/95646)
  - ✅ [获取订单列表](https://developer.work.weixin.qq.com/document/path/95647)
  - ✅ [获取订单详情](https://developer.work.weixin.qq.com/document/path/95648)
  - ✅ [获取订单中的账号列表](https://developer.work.weixin.qq.com/document/path/95649)
  - ✅ [取消订单](https://developer.work.weixin.qq.com/document/path/96106)
  - ✅ [下单购买多企业账号](https://developer.work.weixin.qq.com/document/path/98892)
  - ✅ [获取多企业订单详情](https://developer.work.weixin.qq.com/document/path/98893)

  ### 第三方应用收银台

  > [官方文档：第三方应用收银台](https://developer.work.weixin.qq.com/document/path/97654)

  - ✅ [创建收款订单](https://developer.work.weixin.qq.com/document/path/98045)
  - ✅ [取消收款订单](https://developer.work.weixin.qq.com/document/path/98046)
  - ✅ [获取收款订单列表](https://developer.work.weixin.qq.com/document/path/98053)
  - ✅ [获取收款订单详情](https://developer.work.weixin.qq.com/document/path/98054)
  - ✅ [获取发票列表](https://developer.work.weixin.qq.com/document/path/99436)
  - ✅ [标记开票状态](https://developer.work.weixin.qq.com/document/path/99437)
  - ✅ [签名算法](https://developer.work.weixin.qq.com/document/path/98768)
  - ✅ [使用余额支付订单](https://developer.work.weixin.qq.com/document/path/99415)

  ### 第三方应用推广二维码

  > [官方文档：第三方应用推广二维码](https://developer.work.weixin.qq.com/document/path/90578)

  - ✅ [获取注册码](https://developer.work.weixin.qq.com/document/path/90581)
  - ✅ [查询注册状态](https://developer.work.weixin.qq.com/document/path/90582)
  - ✅ [设置授权应用可见范围](https://developer.work.weixin.qq.com/document/path/90583)
  - ✅ [设置通讯录同步完成](https://developer.work.weixin.qq.com/document/path/90584)
  - ✅ [激活账号](https://developer.work.weixin.qq.com/document/path/95553)
  - ✅ [获取激活码详情](https://developer.work.weixin.qq.com/document/path/95552)
  - ✅ [获取企业的账号列表](https://developer.work.weixin.qq.com/document/path/95544)
  - ✅ [获取成员的激活详情](https://developer.work.weixin.qq.com/document/path/95555)
  - ✅ [账号继承](https://developer.work.weixin.qq.com/document/path/95673)
  - ✅ [分配激活码给下游/下级企业](https://developer.work.weixin.qq.com/document/path/96059)
  - ✅ [获取应用的接口许可状态](https://developer.work.weixin.qq.com/document/path/95844)
  - ✅ [设置企业的许可自动激活状态](https://developer.work.weixin.qq.com/document/path/95873)
  - ✅ [查询企业的许可自动激活状态](https://developer.work.weixin.qq.com/document/path/95874)
  - ✅ [充值账户余额查询](https://developer.work.weixin.qq.com/document/path/100137)
  - ✅ [民生优惠条件查询](https://developer.work.weixin.qq.com/document/path/96515)

  **接口调用许可事件通知：**

  - ✅ [接口许可失效通知](https://developer.work.weixin.qq.com/document/path/95716)
  - ✅ [支付成功通知](https://developer.work.weixin.qq.com/document/path/95804)
  - ✅ [退款结果通知](https://developer.work.weixin.qq.com/document/path/95805)
  - ✅ [自动激活回调通知](https://developer.work.weixin.qq.com/document/path/95994)

  ---

  ## 二、办公功能（企业微信-办公 节点）

  ### 邮件管理

  > [官方文档：邮件](https://developer.work.weixin.qq.com/document/path/95486)

  #### 发送邮件

  - ✅ [发送普通邮件](https://developer.work.weixin.qq.com/document/path/97445)
  - ✅ [发送日程邮件](https://developer.work.weixin.qq.com/document/path/97854)
  - ✅ [发送会议邮件](https://developer.work.weixin.qq.com/document/path/97855)

  #### 获取接收的邮件

  - ✅ [获取收件箱邮件列表](https://developer.work.weixin.qq.com/document/path/97369)
  - ✅ [获取邮件内容](https://developer.work.weixin.qq.com/document/path/97979)

  #### 管理应用邮箱账号

  - ✅ [更新应用邮箱账号](https://developer.work.weixin.qq.com/document/path/97373)
  - ✅ [查询应用邮箱账号](https://developer.work.weixin.qq.com/document/path/97991)

  #### 管理邮件群组

  - ✅ [创建邮件群组](https://developer.work.weixin.qq.com/document/path/95510)
  - ✅ [更新邮件群组](https://developer.work.weixin.qq.com/document/path/97995)
  - ✅ [删除邮件群组](https://developer.work.weixin.qq.com/document/path/97996)
  - ✅ [获取邮件群组详情](https://developer.work.weixin.qq.com/document/path/97997)
  - ✅ [模糊搜索邮件群组](https://developer.work.weixin.qq.com/document/path/97998)

  #### 管理公共邮箱

  - ✅ [创建公共邮箱](https://developer.work.weixin.qq.com/document/path/95511)
  - ✅ [更新公共邮箱](https://developer.work.weixin.qq.com/document/path/98000)
  - ✅ [删除公共邮箱](https://developer.work.weixin.qq.com/document/path/98001)
  - ✅ [获取公共邮箱详情](https://developer.work.weixin.qq.com/document/path/98002)
  - ✅ [模糊搜索公共邮箱](https://developer.work.weixin.qq.com/document/path/98003)

  #### 客户端专用密码

  - ✅ [获取客户端专用密码列表](https://developer.work.weixin.qq.com/document/path/100183)
  - ✅ [删除客户端专用密码](https://developer.work.weixin.qq.com/document/path/100184)

  #### 邮件高级功能账号管理

  - ✅ [分配高级功能账号](https://developer.work.weixin.qq.com/document/path/99316)
  - ✅ [取消高级功能账号](https://developer.work.weixin.qq.com/document/path/99317)
  - ✅ [获取高级功能账号列表](https://developer.work.weixin.qq.com/document/path/99318)
  - ✅ [禁用/启用邮箱账号](https://developer.work.weixin.qq.com/document/path/95512)

  #### 其他邮件客户端登录设置

  - ✅ [获取用户功能属性](https://developer.work.weixin.qq.com/document/path/95513)
  - ✅ [更改用户功能属性](https://developer.work.weixin.qq.com/document/path/98008)
  - ✅ [获取邮件未读数](https://developer.work.weixin.qq.com/document/path/95514)

  ### 文档管理

  #### 管理文档

  - ✅ [新建文档](https://developer.work.weixin.qq.com/document/path/97460)
  - ✅ [重命名文档](https://developer.work.weixin.qq.com/document/path/97736)
  - ✅ [删除文档](https://developer.work.weixin.qq.com/document/path/97735)
  - ✅ [获取文档基础信息](https://developer.work.weixin.qq.com/document/path/97734)
  - ✅ [分享文档](https://developer.work.weixin.qq.com/document/path/97733)

  #### 编辑文档

  - ✅ [编辑文档内容](https://developer.work.weixin.qq.com/document/path/97626)
  - ✅ [编辑表格内容](https://developer.work.weixin.qq.com/document/path/97628)

  #### 编辑智能表格内容

  - ✅ [添加子表](https://developer.work.weixin.qq.com/document/path/99896)
  - ✅ [删除子表](https://developer.work.weixin.qq.com/document/path/99899)
  - ✅ [更新子表](https://developer.work.weixin.qq.com/document/path/99898)
  - ✅ [添加视图](https://developer.work.weixin.qq.com/document/path/99900)
  - ✅ [删除视图](https://developer.work.weixin.qq.com/document/path/99901)
  - ✅ [更新视图](https://developer.work.weixin.qq.com/document/path/99902)
  - ✅ [添加字段](https://developer.work.weixin.qq.com/document/path/99904)
  - ✅ [删除字段](https://developer.work.weixin.qq.com/document/path/99905)
  - ✅ [更新字段](https://developer.work.weixin.qq.com/document/path/99906)
  - ✅ [添加记录](https://developer.work.weixin.qq.com/document/path/99907)
  - ✅ [删除记录](https://developer.work.weixin.qq.com/document/path/99908)
  - ✅ [更新记录](https://developer.work.weixin.qq.com/document/path/99909)
  - ✅ [接收外部数据到智能表格](https://developer.work.weixin.qq.com/document/path/101239/)

  #### 获取文档数据

  - ✅ [获取文档数据](https://developer.work.weixin.qq.com/document/path/97659)
  - ✅ [获取表格行列信息](https://developer.work.weixin.qq.com/document/path/97711)
  - ✅ [获取表格数据](https://developer.work.weixin.qq.com/document/path/97661)

  #### 获取智能表格数据

  - ✅ [查询子表](https://developer.work.weixin.qq.com/document/path/99911)
  - ✅ [查询视图](https://developer.work.weixin.qq.com/document/path/99913)
  - ✅ [查询字段](https://developer.work.weixin.qq.com/document/path/99914)
  - ✅ [查询记录](https://developer.work.weixin.qq.com/document/path/99915)

  #### 设置文档权限

  - ✅ [获取文档权限信息](https://developer.work.weixin.qq.com/document/path/97461)
  - ✅ [修改文档加入规则](https://developer.work.weixin.qq.com/document/path/97778)
  - ✅ [修改文档通知范围及权限](https://developer.work.weixin.qq.com/document/path/97781)
  - ✅ [修改文档安全设置](https://developer.work.weixin.qq.com/document/path/97782)
  - ✅ [管理智能表格内容权限](https://developer.work.weixin.qq.com/document/path/99935)

  #### 管理收集表

  - ✅ [创建收集表](https://developer.work.weixin.qq.com/document/path/97462)
  - ✅ [编辑收集表](https://developer.work.weixin.qq.com/document/path/97816)
  - ✅ [获取收集表信息](https://developer.work.weixin.qq.com/document/path/97817)
  - ✅ [收集表的统计信息查询](https://developer.work.weixin.qq.com/document/path/97818)
  - ✅ [读取收集表答案](https://developer.work.weixin.qq.com/document/path/97819)

  #### 文档高级功能账号管理

  - ✅ [分配高级功能账号](https://developer.work.weixin.qq.com/document/path/99516)
  - ✅ [取消高级功能账号](https://developer.work.weixin.qq.com/document/path/99517)
  - ✅ [获取高级功能账号列表](https://developer.work.weixin.qq.com/document/path/99518)

  #### 文档素材管理

  - ✅ [上传文档图片](https://developer.work.weixin.qq.com/document/path/99933)

  ### 日程管理

  > [官方文档：日程](https://developer.work.weixin.qq.com/document/path/93647)

  #### 管理日历

  - ✅ [创建日历](https://developer.work.weixin.qq.com/document/path/93647)
  - ✅ [更新日历](https://developer.work.weixin.qq.com/document/path/97716)
  - ✅ [获取日历详情](https://developer.work.weixin.qq.com/document/path/97717)
  - ✅ [删除日历](https://developer.work.weixin.qq.com/document/path/97718)

  #### 管理日程

  - ✅ [创建日程](https://developer.work.weixin.qq.com/document/path/93648)
  - ✅ [更新日程](https://developer.work.weixin.qq.com/document/path/97720)
  - ✅ [更新重复日程](https://developer.work.weixin.qq.com/document/path/96204)
  - ✅ [新增日程参与者](https://developer.work.weixin.qq.com/document/path/97721)
  - ✅ [删除日程参与者](https://developer.work.weixin.qq.com/document/path/97722)
  - ✅ [获取日历下的日程列表](https://developer.work.weixin.qq.com/document/path/97723)
  - ✅ [获取日程详情](https://developer.work.weixin.qq.com/document/path/97724)
  - ✅ [取消日程](https://developer.work.weixin.qq.com/document/path/97725)

  ### 会议管理

  > [官方文档：会议](https://developer.work.weixin.qq.com/document/path/99104)

  #### 预约会议基础管理

  - ✅ [创建预约会议](https://developer.work.weixin.qq.com/document/path/99104)
  - ✅ [修改预约会议](https://developer.work.weixin.qq.com/document/path/99047)
  - ✅ [取消预约会议](https://developer.work.weixin.qq.com/document/path/99048)
  - ✅ [获取会议详情](https://developer.work.weixin.qq.com/document/path/99049)
  - ✅ [获取成员会议ID列表](https://developer.work.weixin.qq.com/document/path/99050)

  #### 会议统计管理

  - ✅ [获取会议发起记录](https://developer.work.weixin.qq.com/document/path/99651)

  #### 预约会议高级管理

  - ✅ [创建预约会议（高级）](https://developer.work.weixin.qq.com/document/path/98148)
  - ✅ [修改预约会议（高级）](https://developer.work.weixin.qq.com/document/path/98154)
  - ✅ [获取会议受邀成员列表](https://developer.work.weixin.qq.com/document/path/98160)
  - ✅ [更新会议受邀成员列表](https://developer.work.weixin.qq.com/document/path/98162)
  - ✅ [获取实时会中成员列表](https://developer.work.weixin.qq.com/document/path/98157)
  - ✅ [获取已参会成员列表](https://developer.work.weixin.qq.com/document/path/98156)

  #### 会中控制管理

  - ✅ [静音成员](https://developer.work.weixin.qq.com/document/path/98184)
  - ✅ [移出成员](https://developer.work.weixin.qq.com/document/path/98181)
  - ✅ [结束会议](https://developer.work.weixin.qq.com/document/path/98187)

  #### 录制管理

  - ✅ [获取会议录制列表](https://developer.work.weixin.qq.com/document/path/98192)
  - ✅ [获取会议录制地址](https://developer.work.weixin.qq.com/document/path/98196)

  #### 会议高级功能账号管理

  - ✅ [分配高级功能账号](https://developer.work.weixin.qq.com/document/path/99508)
  - ✅ [取消高级功能账号](https://developer.work.weixin.qq.com/document/path/99509)
  - ✅ [获取高级功能账号列表](https://developer.work.weixin.qq.com/document/path/99510)

  ### 直播管理

  > [官方文档：直播](https://developer.work.weixin.qq.com/document/path/93633)

  - ✅ [创建预约直播](https://developer.work.weixin.qq.com/document/path/93637)
  - ✅ [修改预约直播](https://developer.work.weixin.qq.com/document/path/93640)
  - ✅ [取消预约直播](https://developer.work.weixin.qq.com/document/path/93638)
  - ✅ [删除直播回放](https://developer.work.weixin.qq.com/document/path/93874)
  - ✅ [在微信中观看直播或回放](https://developer.work.weixin.qq.com/document/path/93641)
  - ✅ [获取成员直播ID列表](https://developer.work.weixin.qq.com/document/path/93634)
  - ✅ [获取直播详情](https://developer.work.weixin.qq.com/document/path/93635)
  - ✅ [获取直播观看明细](https://developer.work.weixin.qq.com/document/path/93636)
  - ✅ [获取跳转小程序商城的直播观众信息](https://developer.work.weixin.qq.com/document/path/94442)

  ### 微盘管理

  > [官方文档：微盘](https://developer.work.weixin.qq.com/document/path/93654)

  #### 空间管理

  - ✅ [创建空间](https://developer.work.weixin.qq.com/document/path/93654)
  - ✅ [重命名空间](https://developer.work.weixin.qq.com/document/path/93656)
  - ✅ [删除空间](https://developer.work.weixin.qq.com/document/path/97884)
  - ✅ [获取空间信息](https://developer.work.weixin.qq.com/document/path/93655)
  - ✅ [添加空间成员](https://developer.work.weixin.qq.com/document/path/93658)
  - ✅ [移除空间成员](https://developer.work.weixin.qq.com/document/path/93659)
  - ✅ [空间安全设置](https://developer.work.weixin.qq.com/document/path/97886)
  - ✅ [获取空间邀请链接](https://developer.work.weixin.qq.com/document/path/97967)

  #### 文件管理

  - ✅ [获取文件列表](https://developer.work.weixin.qq.com/document/path/93657)
  - ✅ [上传文件](https://developer.work.weixin.qq.com/document/path/93662)
  - ✅ [下载文件](https://developer.work.weixin.qq.com/document/path/93663)
  - ✅ [创建文件夹](https://developer.work.weixin.qq.com/document/path/97970)
  - ✅ [重命名文件](https://developer.work.weixin.qq.com/document/path/97971)
  - ✅ [移动文件](https://developer.work.weixin.qq.com/document/path/97972)
  - ✅ [删除文件](https://developer.work.weixin.qq.com/document/path/97973)
  - ✅ [获取文件信息](https://developer.work.weixin.qq.com/document/path/97974)

  #### 文件权限管理

  - ✅ [添加文件成员](https://developer.work.weixin.qq.com/document/path/97975)
  - ✅ [移除文件成员](https://developer.work.weixin.qq.com/document/path/97976)
  - ✅ [文件分享设置](https://developer.work.weixin.qq.com/document/path/97977)
  - ✅ [获取文件分享链接](https://developer.work.weixin.qq.com/document/path/97978)
  - ✅ [获取文件权限信息](https://developer.work.weixin.qq.com/document/path/97979)
  - ✅ [文件安全设置](https://developer.work.weixin.qq.com/document/path/97980)

  ### 打卡管理

  > [官方文档：打卡](https://developer.work.weixin.qq.com/document/path/90262)

  - ✅ [获取企业所有打卡规则](https://developer.work.weixin.qq.com/document/path/93384)
  - ✅ [获取员工打卡规则](https://developer.work.weixin.qq.com/document/path/90263)
  - ✅ [获取打卡记录数据](https://developer.work.weixin.qq.com/document/path/90262)
  - ✅ [获取打卡日报数据](https://developer.work.weixin.qq.com/document/path/93374)
  - ✅ [获取打卡月报数据](https://developer.work.weixin.qq.com/document/path/93387)
  - ✅ [获取打卡人员排班信息](https://developer.work.weixin.qq.com/document/path/93380)
  - ✅ [为打卡人员排班](https://developer.work.weixin.qq.com/document/path/93385)
  - ✅ [为打卡人员补卡](https://developer.work.weixin.qq.com/document/path/95803)
  - ✅ [添加打卡记录](https://developer.work.weixin.qq.com/document/path/99647)
  - ✅ [录入打卡人员人脸信息](https://developer.work.weixin.qq.com/document/path/93378)
  - ✅ [获取设备打卡数据](https://developer.work.weixin.qq.com/document/path/94126)
  - ✅ [管理打卡规则](https://developer.work.weixin.qq.com/document/path/98041)

  ### 审批管理

  > [官方文档：审批](https://developer.work.weixin.qq.com/document/path/91854)

  - ✅ [获取审批模板详情](https://developer.work.weixin.qq.com/document/path/91982)
  - ✅ [提交审批申请](https://developer.work.weixin.qq.com/document/path/91853)
  - ✅ [批量获取审批单号](https://developer.work.weixin.qq.com/document/path/91816)
  - ✅ [获取审批申请详情](https://developer.work.weixin.qq.com/document/path/91983)
  - ✅ [获取企业假期管理配置](https://developer.work.weixin.qq.com/document/path/93375)
  - ✅ [获取成员假期余额](https://developer.work.weixin.qq.com/document/path/93376)
  - ✅ [修改成员假期余额](https://developer.work.weixin.qq.com/document/path/93377)
  - ✅ [创建审批模板](https://developer.work.weixin.qq.com/document/path/97437)
  - ✅ [更新审批模板](https://developer.work.weixin.qq.com/document/path/97438)

  ### 汇报管理

  > [官方文档：汇报](https://developer.work.weixin.qq.com/document/path/93496)

  - ✅ [批量获取汇报记录单号](https://developer.work.weixin.qq.com/document/path/93393)
  - ✅ [获取汇报记录详情](https://developer.work.weixin.qq.com/document/path/93394)
  - ✅ [获取汇报统计数据](https://developer.work.weixin.qq.com/document/path/93395)
  - ✅ [下载微盘文件](https://developer.work.weixin.qq.com/document/path/98021)

  ### 人事助手

  > [官方文档：人事助手](https://developer.work.weixin.qq.com/document/path/99130)

  - ✅ [获取员工字段配置](https://developer.work.weixin.qq.com/document/path/99131)
  - ✅ [获取员工花名册信息](https://developer.work.weixin.qq.com/document/path/99132)
  - ✅ [更新员工花名册信息](https://developer.work.weixin.qq.com/document/path/99133)

  ### 会议室管理

  > [官方文档：会议室](https://developer.work.weixin.qq.com/document/path/93618)

  - ✅ [会议室管理](https://developer.work.weixin.qq.com/document/path/93619)
  - ✅ [会议室预定管理](https://developer.work.weixin.qq.com/document/path/93620)
  - ✅ [批量获取申请单ID](https://developer.work.weixin.qq.com/document/path/99883)
  - ✅ [获取申请单详细信息](https://developer.work.weixin.qq.com/document/path/99885)
  - ✅ [设置审批单审批信息](https://developer.work.weixin.qq.com/document/path/99880)

  ### 紧急通知应用

  > [官方文档：紧急通知](https://developer.work.weixin.qq.com/document/path/91623)

  - ✅ [发起语音电话](https://developer.work.weixin.qq.com/document/path/91627)
  - ✅ [获取接听状态](https://developer.work.weixin.qq.com/document/path/91628)

  ---

  ## 三、连接微信功能（企业微信-连接微信 节点）

  ### 客户联系

  > [官方文档：客户联系](https://developer.work.weixin.qq.com/document/path/92109)

  #### 企业服务人员管理

  - ✅ [获取配置了客户联系功能的成员列表](https://developer.work.weixin.qq.com/document/path/92571)

  #### 客户管理

  - ✅ [获取客户列表](https://developer.work.weixin.qq.com/document/path/92113)
  - ✅ [获取客户详情](https://developer.work.weixin.qq.com/document/path/92114)
  - ✅ [批量获取客户详情](https://developer.work.weixin.qq.com/document/path/92994)
  - ✅ [修改客户备注信息](https://developer.work.weixin.qq.com/document/path/92115)

  #### 客户标签管理

  - ✅ [获取企业标签库](https://developer.work.weixin.qq.com/document/path/92117)
  - ✅ [添加企业客户标签](https://developer.work.weixin.qq.com/document/path/92117)
  - ✅ [编辑企业客户标签](https://developer.work.weixin.qq.com/document/path/92117)
  - ✅ [删除企业客户标签](https://developer.work.weixin.qq.com/document/path/92117)
  - ✅ [编辑客户企业标签](https://developer.work.weixin.qq.com/document/path/92118)

  #### 在职继承

  - ✅ [分配在职成员的客户](https://developer.work.weixin.qq.com/document/path/92125)
  - ✅ [查询客户接替状态](https://developer.work.weixin.qq.com/document/path/94088)
  - ✅ [分配在职成员的客户群](https://developer.work.weixin.qq.com/document/path/95703)

  #### 离职继承

  - ✅ [获取待分配的离职成员列表](https://developer.work.weixin.qq.com/document/path/92124)
  - ✅ [分配离职成员的客户](https://developer.work.weixin.qq.com/document/path/94081)
  - ✅ [查询客户接替状态](https://developer.work.weixin.qq.com/document/path/94082)
  - ✅ [分配离职成员的客户群](https://developer.work.weixin.qq.com/document/path/92127)

  #### 客户群管理

  - ✅ [获取客户群列表](https://developer.work.weixin.qq.com/document/path/92120)
  - ✅ [获取客户群详情](https://developer.work.weixin.qq.com/document/path/92122)
  - ✅ [客户群opengid转换](https://developer.work.weixin.qq.com/document/path/94822)

  #### 联系我与客户入群方式

  - ✅ [配置客户联系「联系我」方式](https://developer.work.weixin.qq.com/document/path/92228)
  - ✅ [获取企业已配置的「联系我」方式](https://developer.work.weixin.qq.com/document/path/92228)
  - ✅ [更新企业已配置的「联系我」方式](https://developer.work.weixin.qq.com/document/path/92228)
  - ✅ [删除企业已配置的「联系我」方式](https://developer.work.weixin.qq.com/document/path/92228)
  - ✅ [配置客户群进群方式](https://developer.work.weixin.qq.com/document/path/92229)
  - ✅ [获取客户群进群方式配置](https://developer.work.weixin.qq.com/document/path/92229)
  - ✅ [更新客户群进群方式配置](https://developer.work.weixin.qq.com/document/path/92229)
  - ✅ [删除客户群进群方式配置](https://developer.work.weixin.qq.com/document/path/92229)

  #### 客户朋友圈

  > [官方文档：客户朋友圈概述](https://developer.work.weixin.qq.com/document/path/93506)

  - ✅ [企业发表内容到客户的朋友圈](https://developer.work.weixin.qq.com/document/path/95094)
  - ✅ [停止发表企业朋友圈](https://developer.work.weixin.qq.com/document/path/97612)
  - ✅ [获取客户朋友圈全部的发表记录](https://developer.work.weixin.qq.com/document/path/93333)
  - ✅ [获取客户朋友圈企业发表的列表](https://developer.work.weixin.qq.com/document/path/93333)

  #### 消息推送

  - ✅ [创建企业群发](https://developer.work.weixin.qq.com/document/path/92135)
  - ✅ [提醒成员群发](https://developer.work.weixin.qq.com/document/path/97610)
  - ✅ [停止企业群发](https://developer.work.weixin.qq.com/document/path/97611)
  - ✅ [获取企业的全部群发记录](https://developer.work.weixin.qq.com/document/path/93338)
  - ✅ [发送新客户欢迎语](https://developer.work.weixin.qq.com/document/path/92137)
  - ✅ [添加入群欢迎语素材](https://developer.work.weixin.qq.com/document/path/92366)
  - ✅ [编辑入群欢迎语素材](https://developer.work.weixin.qq.com/document/path/92366)
  - ✅ [获取入群欢迎语素材](https://developer.work.weixin.qq.com/document/path/92366)
  - ✅ [删除入群欢迎语素材](https://developer.work.weixin.qq.com/document/path/92366)

  #### 统计管理

  - ✅ [获取「联系客户统计」数据](https://developer.work.weixin.qq.com/document/path/92132)
  - ✅ [获取「群聊数据统计」数据](https://developer.work.weixin.qq.com/document/path/92133)

  #### 其他接口

  - ✅ [管理商品图册](https://developer.work.weixin.qq.com/document/path/95096)
  - ✅ [管理聊天敏感词](https://developer.work.weixin.qq.com/document/path/95097)
  - ✅ [上传附件资源](https://developer.work.weixin.qq.com/document/path/95098)
  - ✅ [获客助手](https://developer.work.weixin.qq.com/document/path/97297)
  - ✅ [获取已服务的外部联系人](https://developer.work.weixin.qq.com/document/path/99434)

  ### 微信客服

  > [官方文档：微信客服](https://developer.work.weixin.qq.com/document/path/94638)

  #### 客服账号管理

  - ✅ [添加客服账号](https://developer.work.weixin.qq.com/document/path/94662)
  - ✅ [删除客服账号](https://developer.work.weixin.qq.com/document/path/94663)
  - ✅ [修改客服账号](https://developer.work.weixin.qq.com/document/path/94664)
  - ✅ [获取客服账号列表](https://developer.work.weixin.qq.com/document/path/94661)
  - ✅ [获取客服账号链接](https://developer.work.weixin.qq.com/document/path/94665)

  #### 接待人员管理

  - ✅ [添加接待人员](https://developer.work.weixin.qq.com/document/path/94646)
  - ✅ [删除接待人员](https://developer.work.weixin.qq.com/document/path/94647)
  - ✅ [获取接待人员列表](https://developer.work.weixin.qq.com/document/path/94645)

  #### 会话分配与消息收发

  - ✅ [分配客服会话](https://developer.work.weixin.qq.com/document/path/94669)
  - ✅ [发送消息](https://developer.work.weixin.qq.com/document/path/94677)
  - ✅ [发送欢迎语等事件响应消息](https://developer.work.weixin.qq.com/document/path/95122)
  - ✅ [读取消息](https://developer.work.weixin.qq.com/document/path/94670)
  - ✅ [「升级服务」配置](https://developer.work.weixin.qq.com/document/path/94674)
  - ✅ [获取客户基础信息](https://developer.work.weixin.qq.com/document/path/95159)

  #### 统计管理

  - ✅ [获取「客户数据统计」企业汇总数据](https://developer.work.weixin.qq.com/document/path/95489)
  - ✅ [获取「客户数据统计」接待人员明细数据](https://developer.work.weixin.qq.com/document/path/95490)

  #### 机器人管理

  - ✅ [知识库分组管理](https://developer.work.weixin.qq.com/document/path/95971)
  - ✅ [知识库问答管理](https://developer.work.weixin.qq.com/document/path/95972)

  ### 家校应用

  #### 健康上报

  - ✅ [获取健康上报使用统计](https://developer.work.weixin.qq.com/document/path/93676)
  - ✅ [获取健康上报任务ID列表](https://developer.work.weixin.qq.com/document/path/93677)
  - ✅ [获取健康上报任务详情](https://developer.work.weixin.qq.com/document/path/93678)
  - ✅ [获取用户填写答案](https://developer.work.weixin.qq.com/document/path/93679)

  #### 上课直播

  - ✅ [获取老师直播ID列表](https://developer.work.weixin.qq.com/document/path/93739)
  - ✅ [获取直播详情](https://developer.work.weixin.qq.com/document/path/93740)
  - ✅ [获取观看直播统计（旧版）](https://developer.work.weixin.qq.com/document/path/93741)
  - ✅ [获取未观看直播统计（旧版）](https://developer.work.weixin.qq.com/document/path/93742)
  - ✅ [删除直播回放](https://developer.work.weixin.qq.com/document/path/93743)
  - ✅ [获取观看直播统计V2](https://developer.work.weixin.qq.com/document/path/95793)
  - ✅ [获取未观看直播统计V2](https://developer.work.weixin.qq.com/document/path/95795)

  #### 班级收款

  - ✅ [获取学生付款结果](https://developer.work.weixin.qq.com/document/path/94470)
  - ✅ [获取订单详情](https://developer.work.weixin.qq.com/document/path/94471)

  #### 家校沟通 - 基础接口

  - ✅ [获取「学校通知」二维码](https://developer.work.weixin.qq.com/document/path/92320)
  - ✅ [管理「学校通知」的关注模式](https://developer.work.weixin.qq.com/document/path/92318)
  - ✅ [发送「学校通知」](https://developer.work.weixin.qq.com/document/path/92321)
  - ✅ [管理「班级群创建方式」](https://developer.work.weixin.qq.com/document/path/92430)
  - ✅ [外部联系人openid转换](https://developer.work.weixin.qq.com/document/path/92323)
  - ✅ [获取可使用的家长范围](https://developer.work.weixin.qq.com/document/path/94895)

  #### 家校沟通 - 网页授权登录

  - ✅ [开始开发](https://developer.work.weixin.qq.com/document/path/91856)
  - ✅ [构造网页授权链接](https://developer.work.weixin.qq.com/document/path/91857)
  - ✅ [获取访问用户身份](https://developer.work.weixin.qq.com/document/path/91707)
  - ✅ [获取家校访问用户身份](https://developer.work.weixin.qq.com/document/path/95791)

  #### 家校沟通 - 学生与家长管理

  - ✅ [创建学生](https://developer.work.weixin.qq.com/document/path/92325)
  - ✅ [删除学生](https://developer.work.weixin.qq.com/document/path/92326)
  - ✅ [更新学生](https://developer.work.weixin.qq.com/document/path/92327)
  - ✅ [批量创建学生](https://developer.work.weixin.qq.com/document/path/92328)
  - ✅ [批量删除学生](https://developer.work.weixin.qq.com/document/path/92329)
  - ✅ [批量更新学生](https://developer.work.weixin.qq.com/document/path/92330)
  - ✅ [创建家长](https://developer.work.weixin.qq.com/document/path/92331)
  - ✅ [删除家长](https://developer.work.weixin.qq.com/document/path/92332)
  - ✅ [更新家长](https://developer.work.weixin.qq.com/document/path/92333)
  - ✅ [批量创建家长](https://developer.work.weixin.qq.com/document/path/92334)
  - ✅ [批量删除家长](https://developer.work.weixin.qq.com/document/path/92335)
  - ✅ [批量更新家长](https://developer.work.weixin.qq.com/document/path/92336)
  - ✅ [读取学生或家长](https://developer.work.weixin.qq.com/document/path/92337)
  - ✅ [获取部门学生详情](https://developer.work.weixin.qq.com/document/path/92338)
  - ✅ [设置家校通讯录自动同步模式](https://developer.work.weixin.qq.com/document/path/92345)
  - ✅ [获取部门家长详情](https://developer.work.weixin.qq.com/document/path/92446)

  #### 家校沟通 - 部门管理

  - ✅ [创建部门](https://developer.work.weixin.qq.com/document/path/92340)
  - ✅ [更新部门](https://developer.work.weixin.qq.com/document/path/92341)
  - ✅ [删除部门](https://developer.work.weixin.qq.com/document/path/92342)
  - ✅ [获取部门列表](https://developer.work.weixin.qq.com/document/path/92343)
  - ✅ [标准年级对照表](https://developer.work.weixin.qq.com/document/path/92344)
  - ✅ [修改自动升年级的配置](https://developer.work.weixin.qq.com/document/path/92949)

  #### 家校沟通 - 通讯录变更回调

  - ✅ [成员变更事件](https://developer.work.weixin.qq.com/document/path/92032)
  - ✅ [部门变更事件](https://developer.work.weixin.qq.com/document/path/92052)

  ### 政民沟通

  #### 配置网格结构

  - ✅ [添加网格](https://developer.work.weixin.qq.com/document/path/94478)
  - ✅ [编辑网格](https://developer.work.weixin.qq.com/document/path/94479)
  - ✅ [删除网格](https://developer.work.weixin.qq.com/document/path/94480)
  - ✅ [获取网格列表](https://developer.work.weixin.qq.com/document/path/94481)
  - ✅ [获取用户负责及参与的网格列表](https://developer.work.weixin.qq.com/document/path/94482)

  #### 配置事件类别

  - ✅ [添加事件类别](https://developer.work.weixin.qq.com/document/path/94536)
  - ✅ [修改事件类别](https://developer.work.weixin.qq.com/document/path/94537)
  - ✅ [删除事件类别](https://developer.work.weixin.qq.com/document/path/94538)
  - ✅ [获取事件类别列表](https://developer.work.weixin.qq.com/document/path/94540)

  #### 巡查上报

  - ✅ [概述](https://developer.work.weixin.qq.com/document/path/93520)
  - ✅ [获取配置的网格及网格负责人](https://developer.work.weixin.qq.com/document/path/93531)
  - ✅ [获取单位巡查上报数据统计](https://developer.work.weixin.qq.com/document/path/93532)
  - ✅ [获取个人巡查上报数据统计](https://developer.work.weixin.qq.com/document/path/93533)
  - ✅ [获取上报事件分类统计](https://developer.work.weixin.qq.com/document/path/93534)
  - ✅ [获取巡查上报事件列表](https://developer.work.weixin.qq.com/document/path/93536)
  - ✅ [获取巡查上报的事件详情信息](https://developer.work.weixin.qq.com/document/path/93535)

  #### 居民上报

  - ✅ [概述](https://developer.work.weixin.qq.com/document/path/93513)
  - ✅ [获取配置的网格及网格负责人](https://developer.work.weixin.qq.com/document/path/93514)
  - ✅ [获取单位居民上报数据统计](https://developer.work.weixin.qq.com/document/path/93515)
  - ✅ [获取个人居民上报数据统计](https://developer.work.weixin.qq.com/document/path/93516)
  - ✅ [获取上报事件分类统计](https://developer.work.weixin.qq.com/document/path/93517)
  - ✅ [获取居民上报事件列表](https://developer.work.weixin.qq.com/document/path/93518)
  - ✅ [获取居民上报的事件详情信息](https://developer.work.weixin.qq.com/document/path/93519)

  ---

  ## 📚 参考资源

  - [企业微信开发文档](https://developer.work.weixin.qq.com/document/)
  - [企业微信API全局错误码](https://developer.work.weixin.qq.com/document/path/90313)
  - [常见问题 - FAQ](https://developer.work.weixin.qq.com/document/path/90315)
  - [n8n 官方文档](https://docs.n8n.io/)
  - [n8n 社区节点开发文档](https://docs.n8n.io/integrations/creating-nodes/overview/)
  - [n8n 社区节点开发示例](https://docs.n8n.io/integrations/creating-nodes/build/declarative-style-node/)

  ## 📄 许可证

  [MIT](LICENSE.md)


node_type: @bitovi/n8n-nodes-semantic-text-splitter.semantictextsplitter
package_name: @bitovi/n8n-nodes-semantic-text-splitter
display_name: semantictextsplitter
description: N8N node for semantic text splitting
category: Community
development_style: declarative
version: 0.1.3
properties_schema: []
operations: []
credentials_required: []
updated_at: 2026-04-16 09:43:37
author_name: bitovi-os
author_github_url: git+https://github.com/bitovi/n8n-nodes-semantic-text-splitter.git
npm_package_name: @bitovi/n8n-nodes-semantic-text-splitter
npm_version: 0.1.3
community_fetched_at: 2026-04-16T09:43:37.377Z
npm_readme:
  # @bitovi/n8n-nodes-semantic-text-splitter

  This is an n8n community node. It lets you use semantic text splitting in your n8n workflows.

  Semantic text splitting is an advanced text processing technique that splits text based on semantic similarity rather than simple character or token counts. This node implements the methodology described in [5 Levels Of Text Splitting](https://github.com/FullStackRetrieval-com/RetrievalTutorials/blob/main/tutorials/LevelsOfTextSplitting/5_Levels_Of_Text_Splitting.ipynb), which uses embedding models to identify natural breakpoints in text where meaning shifts significantly.

  [n8n](https://n8n.io/) is a [fair-code licensed](https://docs.n8n.io/reference/license/) workflow automation platform.

  [Installation](#installation)  
  [Operations](#operations)  
  [Compatibility](#compatibility)  
  [Usage](#usage)  
  [Resources](#resources)  
  [Version history](#version-history)

  ## Installation

  Follow the [installation guide](https://docs.n8n.io/integrations/community-nodes/installation/) in the n8n community nodes documentation.

  **Quick Installation:**
  - Make sure to allow community nodes with `N8N_COMMUNITY_PACKAGES_ENABLED=true`
  - Once logged in to your N8N web UI, go to `/settings/community-nodes` and type `@bitovi/n8n-nodes-semantic-text-splitter`

  ## Operations

  The Semantic Text Splitter node provides intelligent text splitting capabilities:

  - **Semantic Text Splitting**: Splits text into semantically coherent chunks using embedding-based similarity analysis
  - **Configurable Parameters**: Control splitting behavior with customizable thresholds and window sizes
  - **Integration with Embedding Models**: Works with any n8n-compatible embedding model for similarity calculations

  ## Compatibility

  - **Minimum n8n version**: Compatible with n8n v1.0+
  - **Node.js version**: Requires Node.js 18.10 or higher
  - **Dependencies**: Requires @langchain/core and @langchain/textsplitters

  This node is tested with the latest stable version of n8n and should work with most n8n installations that support community nodes.

  ## Usage

  ### Node Configuration

  The Semantic Text Splitter node requires an embedding model connection and supports the following parameters:

  - **Percentile Threshold for Breakpoints** (default: 0.95): Controls how selective the algorithm is when identifying breakpoints. Higher values result in fewer, larger chunks.
  - **Number of Sentences to Consider in Sliding Window** (default: 3): The size of the sliding window used for embedding comparison.
  - **Minimum Chunk Size** (default: 100): Minimum character length for generated chunks.
  - **Sentence Delimiters** (default: ".!?"): Characters used to identify sentence boundaries.

  ### How It Works

  1. **Sentence Splitting**: Text is first split into sentences using the configured delimiters
  2. **Sliding Windows**: Creates overlapping windows of sentences based on the window size
  3. **Embedding Generation**: Each window is converted to embeddings using the connected embedding model
  4. **Distance Calculation**: Calculates cosine distances between sequential window embeddings
  5. **Breakpoint Detection**: Identifies breakpoints where semantic distance exceeds the threshold
  6. **Chunk Creation**: Creates final text chunks based on identified breakpoints

  ### Example Workflow

  1. Connect a text input (e.g., from a document loader)
  2. Connect an embedding model (e.g., OpenAI Embeddings)
  3. Configure the splitting parameters based on your needs
  4. Connect the output to downstream processing nodes (e.g., vector store, document processing)

  This approach creates more coherent chunks compared to simple character or token-based splitting, making it ideal for RAG (Retrieval Augmented Generation) applications and document processing workflows.

  ## Resources

  * [n8n community nodes documentation](https://docs.n8n.io/integrations/community-nodes/)
  * [5 Levels Of Text Splitting Tutorial](https://github.com/FullStackRetrieval-com/RetrievalTutorials/blob/main/tutorials/LevelsOfTextSplitting/5_Levels_Of_Text_Splitting.ipynb)
  * [LangChain Text Splitters Documentation](https://js.langchain.com/docs/modules/data_connection/document_transformers/)

  ## Version history

  - **v0.1.2** (Current): Latest stable release with full semantic splitting functionality
  - **v0.1.x**: Initial releases with core semantic text splitting features

  ## Need help or have questions?

  Need guidance on leveraging AI agents or N8N for your business? Our [AI Agents workshop](https://hubs.ly/Q02X-9Qq0) will equip you with the knowledge and tools necessary to implement successful and valuable agentic workflows.

  ## License

  [MIT](./LICENSE.md)


node_type: n8n-nodes-mopdf.mopdf
package_name: n8n-nodes-mopdf
display_name: mopdf
description: n8n community node for PDF processing - convert PDF to images, extract text and run OCR
category: Community
development_style: declarative
version: 0.3.1
properties_schema: []
operations: []
credentials_required: []
updated_at: 2026-04-16 09:43:37
author_name: kayjix
author_github_url: git+https://github.com/MoritzBuggisch-art/n8n-nodes-mopdf.git
npm_package_name: n8n-nodes-mopdf
npm_version: 0.3.1
community_fetched_at: 2026-04-16T09:43:37.378Z
npm_readme:
  # n8n-nodes-mopdf

  MoPDF is an n8n community node for local PDF processing. It extracts selectable text, converts PDF pages to images, and runs OCR locally with MuPDF and Tesseract.js.

  The project is intended for self-hosted n8n. Document processing does not depend on remote OCR services or SaaS APIs. Depending on the runtime setup, Tesseract.js language assets may need to be available locally or downloaded separately.

  ## Installation

  Requirements:

  - self-hosted n8n
  - Node.js 18+

  Install from **Settings -> Community Nodes -> Install**:

  ```text
  n8n-nodes-mopdf
  ```

  ## Operations

  | Operation | Input | Output | Notes |
  | --- | --- | --- | --- |
  | PDF to Images | PDF binary | PNG or JPEG binaries | Supports per-page export and page selection |
  | OCR | Image binary | Text or Markdown | Optional word and line coordinates |
  | Extract Text | PDF binary | Text, Markdown, JSON, or HTML | Uses direct PDF text extraction only |
  | Text + OCR Fallback | PDF binary | Text, Markdown, JSON, or HTML | Falls back to OCR only for pages without selectable text |

  ## Output formats

  | Format | Description |
  | --- | --- |
  | Plain text | Clean extracted text without layout markup |
  | Markdown | Compact, structure-aware output for humans and LLM pipelines |
  | JSON | Structured extraction output with layout information |
  | HTML | Raw HTML-style layout export |

  Important n8n note:

  - In n8n Schema and JSON views, multiline strings are shown with escaped `\n` sequences because the UI displays serialized JSON.
  - The stored field value still contains real newline characters.

  ## Project docs

  Detailed architecture, development, publishing and community docs live in the GitHub repository.

  - [Repository home](https://github.com/MoritzBuggisch-art/n8n-nodes-mopdf)
  - See `docs/` for technical documentation
  - See `.github/` for contribution and security guidance

  ## Local development

  Install dependencies once:

  ```bash
  npm install
  ```

  Common commands:

  ```bash
  npm run build
  npm run dev:docker:up
  npm run dev:docker:reload
  npm run dev:docker:logs
  npm run fixtures:build
  npm run fixtures:generate:windows
  ```

  The Docker workflow mounts this repository directly into a local n8n container, so normal code iterations do not require reinstalling the package through the Community Nodes UI.

  Detailed setup, environment variables, fixture generation and manual validation steps are documented in the GitHub repository under `docs/` and `tests/manual-test-plan.md`.

  ## npm package scope

  The published npm package is intentionally minimal:

  - built runtime files from `dist/`
  - package metadata from `package.json`
  - this `README.md`
  - `LICENSE`

  Repository-only assets such as source TypeScript files, Docker setup, fixtures, tests, scripts and GitHub community files stay in GitHub.

  ## Licensing

  This package depends on:

  - [MuPDF](https://mupdf.com/licensing/) - AGPL v3
  - [Tesseract.js](https://github.com/naptha/tesseract.js/blob/master/LICENSE.md) - Apache 2.0

  The repository source is licensed under MIT. The installed npm package also depends on MuPDF (AGPL v3) and Tesseract.js (Apache 2.0), so review upstream obligations before redistribution. The bundled `LICENSE` file includes the repository license text and a dependency notice.


node_type: @mbakgun/n8n-nodes-slack-socket-mode.slacksocketmode
package_name: @mbakgun/n8n-nodes-slack-socket-mode
display_name: slacksocketmode
category: Community
development_style: declarative
version: 1.6.2
properties_schema: []
operations: []
credentials_required: []
updated_at: 2026-04-16 09:43:37
author_name: mbakgun
author_github_url: git+https://github.com/mbakgun/n8n-slack-socket-mode.git
npm_package_name: @mbakgun/n8n-nodes-slack-socket-mode
npm_version: 1.6.2
community_fetched_at: 2026-04-16T09:43:37.379Z
ai_summary_generated_at: 2026-03-25 22:47:20
description:
  Slack Socket Mode Node for n8n that allows you to use +100 Slack events in your n8n instance with proxy mode

npm_readme:
  # @mbakgun/n8n-nodes-slack-socket-mode

  <div align="center">
    <img src="https://raw.githubusercontent.com/n8n-io/n8n/master/assets/n8n-logo.png" width="200" alt="n8n logo">
    <h3>+</h3>
    <img src="https://cdn.worldvectorlogo.com/logos/slack-new-logo.svg" width="100" alt="Slack logo">
  </div>

  This is an n8n community node that lets you use Slack Socket Mode in your n8n workflows. It enables real-time event processing from Slack without requiring public URLs for webhooks.

  Since the current integration of Slack in n8n only supports webhooks, this node allows you to use the Slack Socket Mode to listen to events in your Slack workspace in real-time, even in local development environments.

  [n8n](https://n8n.io/) is a [fair-code licensed](https://docs.n8n.io/reference/license/) workflow automation platform.

  ## Table of Contents
  - [Installation](#installation)
  - [Slack App Setup](#slack-app-setup)
  - [Credentials](#credentials)
  - [Node Configuration](#node-configuration)
  - [Supported Events](#supported-events)
  - [Usage Examples](#usage-examples)
  - [Example Workflow](#example-workflow)
  - [Compatibility](#compatibility)
  - [Resources](#resources)
  - [Version History](#version-history)

  ## Installation

  Follow the [installation guide](https://docs.n8n.io/integrations/community-nodes/installation/) in the n8n community nodes documentation.

  Using Bun (recommended):
  ```bash
  bun add @mbakgun/n8n-nodes-slack-socket-mode
  ```

  Using npm:
  ```bash
  npm install @mbakgun/n8n-nodes-slack-socket-mode
  ```

  After installation, restart n8n and the node will be available in the nodes panel.

  ### Development Setup

  This project uses [Bun](https://bun.sh) as its package manager. To set up your development environment:

  1. Install Bun:
     ```bash
     curl -fsSL https://bun.sh/install | bash
     ```
     
  2. Install dependencies:
     ```bash
     bun install
     ```
     
  3. Build the project:
     ```bash
     bun run build
     ```

  ## Slack App Setup

  Before using this node, you need to create a Slack app with Socket Mode enabled:

  1. Go to [https://api.slack.com/apps](https://api.slack.com/apps) and create a new app
  2. Navigate to "Socket Mode" in the left sidebar and enable it
  3. Generate an 'App-Level Token' with the `connections:write` scope
  4. Go to "OAuth & Permissions" and add the following Bot Token Scopes:
     - `app_mentions:read`
     - `channels:history`
     - `channels:read`
     - `chat:write`
     - `commands`
     - `reactions:read`
     - `team:read`
     - (Add any other scopes required for your use case)
  5. Install the app to your workspace (This will generate a 'Bot User OAuth Token')
  6. Copy the Bot User OAuth Token, App-Level Token, and Signing Secret(from the 'Basic Information' section) for credential setup
  7. Go to 'Event Subscriptions' and enable 'Socket Mode'
  8. Subscribe to the events you want to listen to (e.g. `app_mention`, `message`, `reaction_removed`, `reaction_added`)

  ## Credentials

  To use this node, you need to set up credentials with the following information:

  - **Bot Token**: Your Slack Bot User OAuth Token (starts with `xoxb-`)
  - **App-Level Token**: Your Slack App-Level Token for Socket Mode (starts with `xapp-`)
  - **Signing Secret**: Your Slack App Signing Secret

  These values can be found in your Slack App configuration.

  ## Node Configuration

  The Slack Socket Trigger node can be configured with the following options:

  - **Trigger On**: Select which Slack events should trigger your workflow:
    - All Slack events are now supported (app_mention, message, reaction events, channel events, etc.)
    - See the Supported Events section below for a complete list of available events

  - **Regex Pattern**: Optional regular expression to match against the entire event JSON structure (not just message text). This allows matching on any field in the event, such as subtypes, attachment colors, user IDs, etc.
    - Example: `(?=.*bot_message)(?=.*#FF0000)` matches events that contain both `bot_message` and the color `#FF0000`
    - Example: `help|assist|support` matches events containing any of these words anywhere in the event data
  - **Regex Flags**: Flags for the regular expression (e.g., `g` for global, `i` for case-insensitive)
  - **Slash Commands**: Comma-separated list of slash commands to listen for (e.g., `deploy, status, help`). Leave empty to listen for all slash commands. Do not include the leading slash.
  - **Channels to Watch**: Optional list of channels to filter events. Click **Add Channel** to add channels. Each channel can be selected from the dropdown or entered by ID (e.g., `C1234567890`, `G1234567890`)
  - **Legacy Channel to Watch**: Preserved single-channel selector for workflows created before version 1.4.2

  This node supports using an HTTP or HTTPS proxy by reading the following environment variables:

  ```bash
  export HTTP_PROXY=http://proxy.example.com:3128
  # or
  export HTTPS_PROXY=http://proxy.example.com:3128
  ```

  ## Supported Events

  The node currently supports the following Slack events:

  - `app_mention`: When your bot is mentioned in a channel
  - `block_actions`: When a user interacts with buttons, including NPS-style ratings
  - `message`: When a message is posted to a channel the app is added to
  - `channel_created`: When a new public channel is created
  - `team_join`: When a new user is added to Slack
  - `reaction_added`: When a reaction is added to a message
  - `reaction_removed`: When a reaction is removed from a message
  - `app_deleted`: User has deleted an app
  - `app_home_opened`: User clicked into your App Home
  - `app_installed`: User has installed an app
  - `app_mention`: Subscribe to only the message events that mention your app or bot
  - `app_rate_limited`: Indicates your app's event subscriptions are being rate limited
  - `app_requested`: User requested an app
  - `app_uninstalled`: Your Slack app was uninstalled
  - `app_uninstalled_team`: User has uninstalled an app
  - `assistant_thread_context_changed`: The context changed while an AI assistant thread was visible
  - `assistant_thread_started`: An AI assistant thread was started
  - `bot_added`: A bot user was added
  - `bot_changed`: A bot user was changed
  - `call_rejected`: A Call was rejected
  - `channel_archive`: A channel was archived
  - `channel_created`: A channel was created
  - `channel_deleted`: A channel was deleted
  - `channel_history_changed`: Bulk updates were made to a channel's history
  - `channel_id_changed`: A channel ID changed
  - `channel_joined`: You joined a channel
  - `channel_left`: You left a channel
  - `channel_marked`: Your channel read marker was updated
  - `channel_rename`: A channel was renamed
  - `channel_shared`: A channel has been shared with an external workspace
  - `channel_unarchive`: A channel was unarchived
  - `channel_unshared`: A channel has been unshared with an external workspace
  - `commands_changed`: A slash command has been added or changed
  - `dnd_updated`: Do not Disturb settings changed for the current user
  - `dnd_updated_user`: Do not Disturb settings changed for a member
  - `email_domain_changed`: The workspace email domain has changed
  - `emoji_changed`: A custom emoji has been added or changed
  - `external_org_migration_finished`: An enterprise grid migration has finished on an external workspace
  - `external_org_migration_started`: An enterprise grid migration has started on an external workspace
  - `file_change`: A file was changed
  - `file_comment_added`: A file comment was added
  - `file_comment_deleted`: A file comment was deleted
  - `file_comment_edited`: A file comment was edited
  - `file_created`: A file was created
  - `file_deleted`: A file was deleted
  - `file_public`: A file was made public
  - `file_shared`: A file was shared
  - `file_unshared`: A file was unshared
  - `function_executed`: Your app function is executed as a step in a workflow
  - `goodbye`: The server intends to close the connection soon
  - `grid_migration_finished`: An enterprise grid migration has finished on this workspace
  - `grid_migration_started`: An enterprise grid migration has started on this workspace
  - `group_archive`: A private channel was archived
  - `group_close`: You closed a private channel
  - `group_deleted`: A private channel was deleted
  - `group_history_changed`: Bulk updates were made to a private channel's history
  - `group_joined`: You joined a private channel
  - `group_left`: You left a private channel
  - `group_marked`: A private channel read marker was updated
  - `group_open`: You created a group DM
  - `group_rename`: A private channel was renamed
  - `group_unarchive`: A private channel was unarchived
  - `hello`: The client has successfully connected to the server
  - `im_close`: You closed a DM
  - `im_created`: A DM was created
  - `im_history_changed`: Bulk updates were made to a DM's history
  - `im_marked`: A direct message read marker was updated
  - `im_open`: You opened a DM
  - `invite_requested`: User requested an invite
  - `link_shared`: A message was posted containing one or more links relevant to your application
  - `manual_presence_change`: You manually updated your presence
  - `member_joined_channel`: A user joined a public channel, private channel or MPDM
  - `member_left_channel`: A user left a public or private channel
  - `message`: A message was sent to a channel
  - `message.app_home`: A user sent a message to your Slack app
  - `message.channels`: A message was posted to a channel
  - `message.groups`: A message was posted to a private channel
  - `message.im`: A message was posted in a direct message channel
  - `message.mpim`: A message was posted in a multiparty direct message channel
  - `message_metadata_deleted`: Message metadata was deleted
  - `message_metadata_posted`: Message metadata was posted
  - `message_metadata_updated`: Message metadata was updated
  - `pin_added`: A pin was added to a channel
  - `pin_removed`: A pin was removed from a channel
  - `pref_change`: You have updated your preferences
  - `presence_change`: A member's presence changed
  - `presence_query`: Determine the current presence status for a list of users
  - `presence_sub`: Subscribe to presence events for the specified users
  - `reaction_added`: A member has added an emoji reaction to an item
  - `reaction_removed`: A member removed an emoji reaction
  - `reconnect_url`: Experimental
  - `resources_added`: Access to a set of resources was granted for your app
  - `resources_removed`: Access to a set of resources was removed for your app
  - `scope_denied`: OAuth scopes were denied to your app
  - `scope_granted`: OAuth scopes were granted to your app
  - `shared_channel_invite_accepted`: A shared channel invite was accepted
  - `shared_channel_invite_approved`: A shared channel invite was approved
  - `shared_channel_invite_declined`: A shared channel invite was declined
  - `shared_channel_invite_received`: A shared channel invite was sent to a Slack user
  - `shared_channel_invite_requested`: A shared channel invite was requested
  - `star_added`: A member has saved an item for later or starred an item
  - `star_removed`: A member has removed an item saved for later or starred an item
  - `subteam_created`: A User Group has been added to the workspace
  - `subteam_members_changed`: The membership of an existing User Group has changed
  - `subteam_self_added`: You have been added to a User Group
  - `subteam_self_removed`: You have been removed from a User Group
  - `subteam_updated`: An existing User Group has been updated or its members changed
  - `team_access_granted`: Access to a set of teams was granted to your org app
  - `team_access_revoked`: Access to a set of teams was revoked from your org app
  - `team_domain_change`: The workspace domain has changed
  - `team_join`: A new member has joined
  - `team_migration_started`: The workspace is being migrated between servers
  - `team_plan_change`: The account billing plan has changed
  - `team_pref_change`: A preference has been updated
  - `team_profile_change`: The workspace profile fields have been updated
  - `team_profile_delete`: The workspace profile fields have been deleted
  - `team_profile_reorder`: The workspace profile fields have been reordered
  - `team_rename`: The workspace name has changed
  - `tokens_revoked`: API tokens for your app were revoked
  - `url_verification`: Verifies ownership of an Events API Request URL
  - `user_change`: A member's data has changed
  - `user_resource_denied`: User resource was denied to your app
  - `user_resource_granted`: User resource was granted to your app
  - `user_resource_removed`: User resource was removed from your app
  - `user_typing`: A channel member is typing a message
  - `view_submission`: When a modal view is submitted 
  - `view_closed`: When a modal view is closed
  - `workflow_deleted`: A workflow that contains a step supported by your app was deleted
  - `workflow_published`: A workflow that contains a step supported by your app was published
  - `workflow_step_deleted`: A workflow step supported by your app was removed from a workflow
  - `workflow_step_execute`: A workflow step supported by your app should execute
  - `workflow_unpublished`: A workflow that contains a step supported by your app was unpublished
  - `slash_command`: When a user invokes a slash command

  ## Usage Examples

  ### Respond to mentions

  Configure the node to trigger on `app_mention` events to make your workflow respond when someone mentions your bot.

  ### Process messages matching a pattern

  Use the Regex Pattern field to only trigger on messages that match a specific pattern:
  - Pattern: `help|assist|support`
  - Flags: `i`

  This will trigger the workflow only when messages containing "help", "assist", or "support" (case-insensitive) are posted.

  ### Monitor channel creation

  Set the trigger to `channel_created` to run workflows whenever a new channel is created in your workspace.

  ## Example Workflow

  Here's an example of a simple workflow that responds to Slack mentions:

  ```
  [Slack Socket Trigger] → [JSON Parse] → [IF] → [HTTP Request] → [Slack]
  ```

  1. **Slack Socket Trigger**: Configured to trigger on app mentions
  2. **JSON Parse**: Extracts the message text and channel from the event data
  3. **IF**: Checks if the message contains certain keywords
  4. **HTTP Request**: Fetches relevant data based on the message
  5. **Slack**: Sends a response back to the channel

  This workflow allows you to create a Slack bot that responds to mentions with data from external APIs, all without needing to expose your n8n instance to the internet.

  ## Compatibility

  - Requires n8n version 1.6.0 or later
  - Tested against n8n versions 1.91.3
  - Uses Bun as package manager for improved performance

  ## Resources

  - [n8n community nodes documentation](https://docs.n8n.io/integrations/community-nodes/)
  - [Slack API Documentation](https://api.slack.com/apis)
  - [Slack Socket Mode Documentation](https://api.slack.com/apis/connections/socket)
  - [Slack Events API Documentation](https://api.slack.com/events)
  - [Bun Documentation](https://bun.sh/docs)

  ### Workflow Building Tools

  - [n8n Builder](https://n8nbuilder.dev/) - AI-powered workflow generator. Great for quickly prototyping Socket Mode workflows with natural language.

  ## Contributors

  We appreciate all contributions to this project! 🎉

  ### How to Contribute

  1. Fork the repository
  2. Create a feature branch (`git checkout -b feature/amazing-feature`)
  3. Make your changes
  4. Run tests and ensure build passes (`bun run build`)
  5. Commit your changes (`git commit -m 'Add some amazing feature'`)
  6. Push to the branch (`git push origin feature/amazing-feature`)
  7. Open a Pull Request

  Special thanks to all contributors who help improve this project!

  ## Version History

  - **1.6.1**: Added slash command trigger support by **[@ydogukan-yd](https://github.com/ydogukan-yd)**
    - Added `slash_command` event listener for handling slash commands
    - Added configurable slash commands field to filter specific commands
    - Enables building interactive Slack workflows with custom slash commands in n8n
  - **1.6.0**: Upgraded @slack/bolt to v4.6.0
    - Fixed dependency resolution issues that caused `ENOENT` errors during installation
    - Resolved nested dependency conflicts with `@slack/logger` and other Slack packages
    - If you experienced installation errors, please upgrade to 1.6.0
  - **1.5.1**: Added modal view event support by **[@unbalanced](https://github.com/unbalanced)**
    - Added `view_submission` event listener for handling modal form submissions
    - Added `view_closed` event listener for detecting when modals are dismissed
    - Enables building interactive Slack workflows with modal forms in n8n
  - **1.5.0**: Enhanced regex pattern matching for entire event structure
    - Changed regex matching to work against the entire event JSON instead of just the text field
    - Enables matching on any event property including subtypes, attachment colors, metadata, etc.
    - Supports complex patterns like `(?=.*bot_message)(?=.*#FF0000)` to match multiple conditions
    - Provides more flexible event filtering for advanced use cases
  - **1.4.2**: Fixed multi-channel selector implementation
    - Each channel entry now properly supports both dropdown selection and manual ID input
    - Maintained backward compatibility with legacy single-channel selector
  - **1.3.6**: Production release with enhanced event handler architecture
    - Stable release of message event handler improvements from 1.3.5
    - Production-ready named function handlers for all message events
    - Verified event capture and processing reliability
    - Ready for enterprise deployments with improved debugging capabilities
  - **1.3.5**: Enhanced message event handler architecture for better app event handling
    - Refactored message event handlers into named functions (handleMessageEvent, handleMessageSubtypeEvent)
    - Fixed event capture and processing by separating handler definition from registration
    - Improved app.event() listener registration to properly catch all message events
    - Enhanced code maintainability and debugging with named function handlers
    - Better event handling reliability for message and message subtype events
  - **1.3.3**: Improved message event handling
    - Refactored message event listeners to use app.event() instead of app.message()
    - Fixed regex state management by resetting lastIndex for global regex flags
    - Enhanced null safety with explicit event and text validation
    - Reduced code duplication in message subtype handling
    - Improved early return pattern for better code readability
  - **1.3.2**: Fixed block actions acknowledgement by **[@keenlim](https://github.com/keenlim)**
    - Added proper acknowledgement for block actions interactions
    - Fixed socket to Slack communication for button interactions
  - **1.3.1**: Enhanced channel filtering for all event types
    - Fixed channel filtering for events like `reaction_added`, `pin_added`, `file_shared`, etc.
    - Added comprehensive channel ID extraction from multiple event properties (`event.channel`, `event.item.channel`, `event.item.channel_id`, `event.file.channels`)
  - **1.3.0**: Channel filtering feature by **[@tongshengng](https://github.com/tongshengng)**
    - Added "Channel to watch" field similar to official Slack trigger node
    - Implemented optional channel ID parameter to filter incoming Slack events
    - Added searchable dropdown with channel selection via Slack API
    - Improved event targeting by filtering events from specific channels only
    - Added channel ID format validation for manual entry
  - **1.2.5**: Added proxy support by **[@minimorph223](https://github.com/minimorph223)**
    - Added `http-proxy-agent` dependency for HTTP/HTTPS proxy support
    - Enhanced connectivity options for enterprise environments
  - **1.2.3**: Enhanced message filtering by **[@macchiang](https://github.com/macchiang)**
    - Fixed invalid `message.im` event type with proper channel_type filtering
    - Added support for filtering Slack messages by channel type (channels, groups, im, mpim, app_home)
    - Improved message filtering capabilities using Slack Bolt framework best practices
    - Resolved TypeScript typing issues
  - **1.2.0**: Added support for all Slack events
    - Updated to include all events from the Slack Events API
    - Improved event descriptions and documentation
  - **1.0.0**: Initial release - Project initialized with Socket Mode support for Slack events
    - Support for app_mention, message, reaction events
    - Added button interaction support

  ## License

  MIT License

  Copyright (c) 2025 Mehmet Burak Akgün

  Permission is hereby granted, free of charge, to any person obtaining a copy
  of this software and associated documentation files (the "Software"), to deal
  in the Software without restriction, including without limitation the rights
  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
  copies of the Software, and to permit persons to whom the Software is
  furnished to do so, subject to the following conditions:

  The above copyright notice and this permission notice shall be included in all
  copies or substantial portions of the Software.

  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
  SOFTWARE.

ai_documentation_summary:
  {"purpose":"A n8n community node that enables real-time Slack Socket Mode integration, allowing workflows to listen to and process over 100 Slack events without requiring public webhook URLs.","capabilities":["Real-time event processing from Slack","Support for 100+ Slack event types including messages, reactions, and channel events","Regex pattern matching on entire event JSON structures","Regex flag configuration for flexible filtering","Slash command listening","Channel filtering by ID","HTTP/HTTPS proxy support for local development","No public webhook URL requirement"],"authentication":"None (uses Slack App-Level Token, Bot User OAuth Token, and Signing Secret via credentials)","commonUseCases":["Real-time monitoring of Slack messages and reactions","Automated responses to specific message patterns or subtypes","Local development environments without exposing public webhooks","Slash command automation","Event-based workflow triggers based on channel or user activity"],"limitations":["Requires manual Slack App setup with Socket Mode enabled","Requires specific token scopes and permissions to be configured in Slack","Proxy configuration requires environment variables (HTTP_PROXY or HTTPS_PROXY)","Legacy channel selector may not work in newer workflows (version 1.4.2+)"],"relatedNodes":["Slack Webhook Trigger","Slack Webhook Response","Slack Webhook Trigger (Community)","Slack Webhook Response (Community)"]}


node_type: n8n-nodes-evolution-api-v2.evolutionapiv2
package_name: n8n-nodes-evolution-api-v2
display_name: evolutionapiv2
description: N8N Community Node for Evolution API v2
category: Community
development_style: declarative
version: 1.1.11
properties_schema: []
operations: []
credentials_required: []
updated_at: 2026-04-16 09:43:37
author_name: jfcardososantos
author_github_url: git+https://github.com/jfcardososantos/n8n-nodes-evolution-api-v2.git
npm_package_name: n8n-nodes-evolution-api-v2
npm_version: 1.1.11
community_fetched_at: 2026-04-16T09:43:37.380Z
npm_readme:
  # N8N Evolution API v2 Community Node

  Este é um community node para o N8N que permite integração com a Evolution API v2 para WhatsApp.

  ## 🚀 Funcionalidades

  - **Gerenciamento de Instâncias**: Criar, conectar, desconectar e gerenciar instâncias do WhatsApp
  - **Envio de Mensagens**: Enviar mensagens de texto e mídia
  - **Gerenciamento de Grupos**: Criar grupos e buscar membros
  - **Verificação de Chat**: Verificar se um número é WhatsApp
  - **Webhooks**: Configurar webhooks para eventos
  - **Integrações**: Suporte para integração com Chatwoot

  ## 📦 Instalação

  ### Via NPM (Recomendado)

  ```bash
  npm install n8n-nodes-evolution-api-v2
  ```

  ### Via N8N Community Nodes

  1. Vá para **Settings** > **Community Nodes**
  2. Clique em **Install**
  3. Digite: `n8n-nodes-evolution-api-v2`
  4. Clique em **Install**

  ## 🔧 Configuração

  ### Credenciais

  1. Crie uma nova credencial do tipo **Evolution API**
  2. Configure:
     - **Server URL**: URL do seu servidor Evolution API
     - **API Token**: Token de autenticação da API

  ### Recursos Disponíveis

  #### Instância
  - **Criar Instância**: Cria uma nova instância do WhatsApp
  - **Buscar Instâncias**: Lista todas as instâncias disponíveis
  - **Conectar Instância**: Conecta a uma instância específica
  - **Reiniciar Instância**: Reinicia uma instância
  - **Estado da Conexão**: Verifica o estado da conexão
  - **Logout**: Faz logout de uma instância
  - **Deletar Instância**: Remove uma instância
  - **Definir Presença**: Define o status de presença

  #### Mensagem
  - **Enviar Texto**: Envia uma mensagem de texto
  - **Enviar Imagem**: Envia uma imagem com legenda

  #### Grupo
  - **Criar Grupo**: Cria um novo grupo
  - **Buscar Membros**: Lista membros de um grupo

  #### Chat
  - **Verificar WhatsApp**: Verifica se um número é WhatsApp

  #### Evento
  - **Webhook**: Configura webhooks para eventos

  #### Integração
  - **Chatwoot**: Configura integração com Chatwoot

  ## 🛠️ Desenvolvimento

  ### Pré-requisitos

  - Node.js 18+
  - npm ou yarn

  ### Instalação Local

  ```bash
  git clone https://github.com/jfcardososantos/n8n-nodes-evolution-api-v2.git
  cd n8n-nodes-evolution-api-v2
  npm install
  ```

  ### Scripts Disponíveis

  ```bash
  # Build do projeto
  npm run build

  # Desenvolvimento com watch
  npm run dev

  # Linting
  npm run lint

  # Formatação
  npm run format

  # Release (patch, minor, major)
  npm run release:patch
  npm run release:minor
  npm run release:major
  ```

  ## 📝 Exemplos de Uso

  ### Enviar Mensagem de Texto

  ```javascript
  // Configuração do node
  {
    "resource": "message",
    "operation": "sendText",
    "instanceName": "minha-instancia",
    "number": "5511999999999",
    "messageText": "Olá! Esta é uma mensagem de teste."
  }
  ```

  ### Criar Grupo

  ```javascript
  // Configuração do node
  {
    "resource": "group",
    "operation": "createGroup",
    "instanceName": "minha-instancia",
    "subject": "Grupo de Teste",
    "participants": ["5511999999999", "5511888888888"]
  }
  ```

  ## 🤝 Contribuição

  1. Faça um fork do projeto
  2. Crie uma branch para sua feature (`git checkout -b feature/AmazingFeature`)
  3. Commit suas mudanças (`git commit -m 'Add some AmazingFeature'`)
  4. Push para a branch (`git push origin feature/AmazingFeature`)
  5. Abra um Pull Request

  ## 📄 Licença

  Este projeto está licenciado sob a Licença MIT - veja o arquivo [LICENSE](LICENSE) para detalhes.

  ## 👨‍💻 Autor

  **JF Cardoso Santos**
  - Email: jfcardososantos@gmail.com
  - GitHub: [@jfcardososantos](https://github.com/jfcardososantos)

  ## 🔗 Links

  - [N8N](https://n8n.io/)
  - [Evolution API](https://doc.evolution-api.com/)
  - [NPM Package](https://www.npmjs.com/package/n8n-nodes-evolution-api-v2)

  ## 📈 Versionamento

  Este projeto usa [SemVer](http://semver.org/) para versionamento. Para ver as versões disponíveis, veja as [tags neste repositório](https://github.com/jfcardososantos/n8n-nodes-evolution-api-v2/tags).

  ## 🆘 Suporte

  Se você encontrar algum problema ou tiver dúvidas, por favor:

  1. Verifique a [documentação da Evolution API](https://doc.evolution-api.com/)
  2. Abra uma [issue no GitHub](https://github.com/jfcardososantos/n8n-nodes-evolution-api-v2/issues)
  3. Entre em contato via email: jfcardososantos@gmail.com 


node_type: n8n-nodes-html-tag-extract.htmltagextract
package_name: n8n-nodes-html-tag-extract
display_name: htmltagextract
description: n8n helper nodes to extract HTML tags, parse JSON and more
category: Community
development_style: declarative
version: 0.2.0
properties_schema: []
operations: []
credentials_required: []
updated_at: 2026-04-16 09:43:37
author_name: danielvee
author_github_url: git+https://github.com/defmans7/n8n-nodes-html-tag-extract.git
npm_package_name: n8n-nodes-html-tag-extract
npm_version: 0.2.0
community_fetched_at: 2026-04-16T09:43:37.380Z
npm_readme:
  # n8n-nodes-html-tag-extract

  This is an n8n community node. It lets you use extract common HTML tags from an HTML string in your n8n workflows.

  This is my first community node for n8n, I've also included a JSON parse helper node that I use in my workflows. 
  I find it useful to have a node that can parse JSON strings and return the parsed object, 
  because repeating the same custom code node for all my workflows is a bit cumbersome.

  HTML Tag Extract, provides helper nodes to extract HTML tags, parse JSON... and that's basically it.

  [n8n](https://n8n.io/) is a [fair-code licensed](https://docs.n8n.io/reference/license/) workflow automation platform.

  [Installation](#installation)  
  [Operations](#operations)  
  [Usage](#usage)  
  [Acknowledgements](#acknowledgements)  
  [Further (future) development](#further-future-development)

  ## Installation

  Follow the [installation guide](https://docs.n8n.io/integrations/community-nodes/installation/) in the n8n community nodes documentation.

  ## Operations

  * Extract HTML Tags
  * Parse JSON

  ## Usage

  ### Extract HTML Tags
  * Pass a string containing HTML to the Extract HTML Tags node, and it will return the data object containing the tags name and the tag's content.
  * Some tags will be an array of objects, for example, the heading tags (h1, h2, h3, h4, h5, h6) will be an array of objects, each object containing the tag's name and content.
  * There is also a word and character count for the text content of the page.

  ### Parse JSON
  * Pass a string containing JSON to the Parse JSON node, and it will return the parsed object.
  * Sometimes LLM output contains a JSON string within a code block: \```json {"key": "value"} ``` and this node will remove the junk and return the parsed object.

  ## Acknowledgements

  * [Cheerio provides the HTML Tag Extract node](https://www.npmjs.com/package/cheerio)
  * N8N team for the great platform and documentation
  * Aider, mainly for commit messages

  ## Further (future) development

  I'm planning to add more features to this node, such as allowing for extracting specific tags and CSS selectors.

  Also:
  * Parse YouTube iframes / links and extract the video ID
  * Extract images with alt text (currently only extracts the image URL)
  * Find all articles
  * List internal and external links separately
  * Implement better cleanup methods for the text content
  * Maybe include Markdown as an output format, but there's already a community node for [HTML to Markdown conversion](https://www.npmjs.com/package/n8n-nodes-turndown-html-to-markdown)


node_type: n8n-nodes-webpage-content-extractor.webpagecontentextractor
package_name: n8n-nodes-webpage-content-extractor
display_name: webpagecontentextractor
category: Community
development_style: declarative
version: 0.1.3
properties_schema: []
operations: []
credentials_required: []
updated_at: 2026-04-16 09:43:37
author_name: savjee
author_github_url: git+https://github.com/Savjee/n8n-nodes-webpage-content-extractor.git
npm_package_name: n8n-nodes-webpage-content-extractor
npm_version: 0.1.3
community_fetched_at: 2026-04-16T09:43:37.381Z
description:
  Extracts the content from a given URL. Similar to the 'Reader' mode in your browser, it ignores headers, footers, banners, etc.

npm_readme:
  # n8n-nodes-webpage-content-extractor

  This is an n8n community node. It extracts the contents from a given URL. Similar to the 'Reader' mode in your browser, it ignores headers, footers, banners, etc.

  It's based on the [Readability library](https://github.com/mozilla/readability) that is used by Firefox's Reader View.


  ---

  [Installation](#installation)  
  [Compatibility](#compatibility)  
  [Usage](#usage)  <!-- delete if not using this section -->  
  [Resources](#resources)  
  [Version history](#version-history)  <!-- delete if not using this section -->  


  ## Installation

  Follow the [installation guide](https://docs.n8n.io/integrations/community-nodes/installation/) in the n8n community nodes documentation.


  ## Compatibility

  Tested on n8n v1.20.0 and above.

  ## Usage

  To use this node, fetch a website's HTML code with a "HTTP Request" node and then pass it on to WebpageContentExtractor.

  This allows you to configure all aspects of the web request (method, authentication, headers, etc).


  ## Resources

  * [n8n community nodes documentation](https://docs.n8n.io/integrations/community-nodes/)


  ## Version history

  ### 0.1.3 (2025-01-07)
  * Updated dependencies & removed Gulp

  ### 0.1.2 (2024-11-20)
  * Add "content" attribute to output

  ### 0.1.1
  * Fixing the README

  ### 0.1.0
  Initial release


node_type: @bitovi/n8n-nodes-watsonx.watsonx
package_name: @bitovi/n8n-nodes-watsonx
display_name: watsonx
description: N8N node to connect to WatsonX
category: Community
development_style: declarative
version: 0.2.5
properties_schema: []
operations: []
credentials_required: []
updated_at: 2026-04-16 09:43:37
author_name: bitovi-os
author_github_url: git+https://github.com/bitovi/n8n-nodes-watsonx.git
npm_package_name: @bitovi/n8n-nodes-watsonx
npm_version: 0.2.5
community_fetched_at: 2026-04-16T09:43:37.382Z
npm_readme:
  # @bitovi/n8n-nodes-watsonx

  This is an n8n community node that lets you use IBM watsonx.ai in your n8n workflows.

  IBM watsonx.ai is an enterprise-ready AI and data platform designed to multiply the impact of AI across your business. It provides access to foundation models for language, code, and multimodal tasks, with options for both IBM Cloud and on-premise Cloud Pak for Data deployments.

  [n8n](https://n8n.io/) is a [fair-code licensed](https://docs.n8n.io/reference/license/) workflow automation platform.

  [Installation](#installation)  
  [Operations](#operations)  
  [Credentials](#credentials)  
  [Compatibility](#compatibility)  
  [Usage](#usage)  
  [Resources](#resources)  

  ## Installation

  Follow the [installation guide](https://docs.n8n.io/integrations/community-nodes/installation/) in the n8n community nodes documentation.

  Alternative installation method:
  - Make sure to allow community nodes with `N8N_COMMUNITY_PACKAGES_ENABLED=true`
  - Once logged in to your N8N web UI, go to `/settings/community-nodes` and type `@bitovi/n8n-nodes-watsonx`

  ## Operations

  This package provides three nodes for different AI operations:

  ### WatsonX LLM
  - **Chat completion**: Generate text responses using IBM watsonx foundation models
  - **Model selection**: Choose from available foundation models in your watsonx instance
  - **Parameter control**: Configure temperature, max tokens, top-p, and other model parameters
  - **Langfuse integration**: Built-in tracking and monitoring of LLM interactions

  ### WatsonX AI Agent
  - **AI Agent execution**: Create autonomous agents that can use tools and make decisions
  - **Tool integration**: Connect with n8n tools and external APIs
  - **Memory support**: Maintain conversation context across interactions
  - **Output parsing**: Structure agent responses with custom output formats
  - **Iteration control**: Set maximum iterations and return intermediate steps
  - **System message customization**: Define agent behavior and personality
  - **Batch Processing, returning Intermediate Steps and more!**

  ### Embeddings WatsonX
  - **Text embeddings**: Convert text into vector representations for semantic search
  - **Model selection**: Use watsonx embedding models for your specific use case
  - **Vector store integration**: Connect directly with n8n vector store nodes

  ## Credentials

  To use this node, you need to authenticate with IBM watsonx.ai. The package supports two authentication methods:

  ### Prerequisites
  - An IBM watsonx.ai account (either IBM Cloud or Cloud Pak for Data)
  - A watsonx project with appropriate permissions
  - API credentials for your chosen environment

  ### Authentication Methods

  #### IBM Cloud (IAM Authentication)
  For IBM Cloud-hosted watsonx.ai:
  1. **IBM Cloud API Key**: Your IBM Cloud IAM API Key
  2. **Project ID**: Your watsonx.ai project ID (found in the "Manage" tab of your project)
  3. **Region**: Select your IBM Cloud region (us-south, eu-gb, eu-de, or jp-tok)

  #### On-Premise (Cloud Pak for Data Authentication)
  For on-premise Cloud Pak for Data instances:
  1. **On-Premise URL**: The base URL of your CP4D instance (e.g., https://your-watsonx-host.com)
  2. **Username**: Your CP4D username
  3. **API Key**: Your username-associated API key from your CP4D profile
  4. **Project ID**: Your watsonx.ai project ID

  ### Setting up Credentials
  1. In n8n, go to **Settings** > **Credentials**
  2. Click **Add Credential** and search for "WatsonX API"
  3. Select your environment type (IBM Cloud or On-Premise)
  4. Fill in the required fields based on your chosen authentication method
  5. Test the connection to ensure it's working properly

  ## Compatibility

  - **Minimum n8n version**: 1.94.0
  - **Node.js**: 18.10 or higher
  - **Package manager**: pnpm 9.1 or higher
  - **Tested on n8n 1.104.1**

  This package is tested against 1.104.1 of n8n and is regularly updated to maintain compatibility.

  ## Usage

  ### Basic LLM Usage
  1. Add the **WatsonX LLM** node to your workflow
  2. Configure your watsonx credentials
  3. Select a foundation model from the dropdown
  4. Connect to other n8n nodes to process input and output

  ### Creating AI Agents
  1. Add the **AgentV2 Custom** node to your workflow
  2. Connect a **WatsonX LLM** node as the chat model
  3. Add any tools your agent should have access to
  4. Configure the system message to define agent behavior
  5. Optionally add memory and output parsers for more advanced functionality

  ### Working with Embeddings
  1. Add the **Embeddings WatsonX** node to your workflow
  2. Configure your watsonx credentials
  3. Select an embedding model
  4. Connect to vector store nodes for semantic search capabilities

  ## Resources

  * [n8n community nodes documentation](https://docs.n8n.io/integrations/community-nodes/)
  * [IBM watsonx.ai documentation](https://www.ibm.com/docs/en/watsonx-as-a-service)
  * [Langchain IBM integration documentation](https://js.langchain.com/docs/integrations/llms/ibm)
  * [IBM Cloud API documentation](https://cloud.ibm.com/apidocs)

  ## Need help or have questions?

  Need guidance on leveraging AI agents or N8N for your business? Our [AI Agents workshop](https://hubs.ly/Q02X-9Qq0) will equip you with the knowledge and tools necessary to implement successful and valuable agentic workflows.

  ## License

  [MIT](./LICENSE.md)


node_type: n8n-nodes-openai-advanced.openaiadvanced
package_name: n8n-nodes-openai-advanced
display_name: openaiadvanced
description: n8n community node for OpenAI with LiteLLM prompt caching support
category: Community
development_style: declarative
version: 0.1.25
properties_schema: []
operations: []
credentials_required: []
updated_at: 2026-04-16 09:43:37
author_name: unbalanced
author_github_url: git+https://github.com/<...>/n8n-nodes-<...>.git
npm_package_name: n8n-nodes-openai-advanced
npm_version: 0.1.25
community_fetched_at: 2026-04-16T09:43:37.382Z
ai_summary_generated_at: 2026-03-25 22:47:20
npm_readme:
  # n8n-nodes-openai-advanced

  An n8n community node that extends the built-in OpenAI Chat Model to support **non** Open AI models and features for models that are proxied/consumed via  LiteLLM.

  The Lib enables support to **prompt caching** and **Anthropic Tool Search Tool**.

  ## Features

  - Drop-in replacement for n8n's built-in OpenAI Chat Model node
  - **Prompt caching** via LiteLLM — reduce costs and latency for repeated system prompts
  - **Cache TTL** control — choose between 5-minute (default) or 1-hour cache duration
  - **Cache usage logging** — monitor cache hits/writes/misses in n8n logs
  - **Tool Search** via LiteLLM — Anthropic's dynamic tool discovery for large tool catalogs (Regex or BM25 variants)
  - Base URL override for LiteLLM or other OpenAI-compatible proxies
  - Dynamic model list from your API endpoint
  - All standard ChatOpenAI options: temperature, top P, frequency/presence penalty, max tokens, response format, reasoning effort, timeout, retries

  ## Installation

  ### In n8n (Community Nodes)

  1. Go to **Settings > Community Nodes**
  2. Install: `n8n-nodes-openai-advanced`

  ### Manual Installation

  ```bash
  cd ~/.n8n/nodes
  npm install n8n-nodes-openai-advanced
  ```

  Restart n8n after installation.

  ## Usage

  1. Add the **OpenAI Chat Model Advanced** node to your workflow
  2. Connect it to an AI Agent or Chain as the language model
  3. Configure your OpenAI API credentials (reuses the built-in `openAiApi` credential)
  4. Select a model from the list or enter a model ID manually

  ### Prompt Caching (LiteLLM)

  To enable prompt caching for Anthropic models through LiteLLM:

  1. Set the **Base URL** to your LiteLLM proxy endpoint
  2. Enable **Enable Prompt Caching (LiteLLM)** in the Options
  3. Optionally set **Cache TTL** to `1 Hour` (default is `5 Minutes`)

  #### How it works

  When prompt caching is enabled, the node:

  - Adds the `anthropic-beta: prompt-caching-2024-07-31` header
  - Injects `cache_control_injection_points` into the request body, telling LiteLLM to add `cache_control` blocks to system messages
  - Logs cache usage to n8n's logger (visible in container logs)

  #### Requirements

  - A LiteLLM proxy configured with an Anthropic model (e.g., `claude-sonnet-4-20250514`)
  - System prompt must be at least **1024 tokens** for caching to activate (Anthropic requirement)

  #### Monitoring Cache Usage

  When prompt caching is enabled, the node logs cache activity:

  ```
  [PromptCache] prompt=1500 completion=200 cache_creation=1024 cache_read=0
  [PromptCache] Cache WRITE — 1024 tokens written to cache
  ```

  On subsequent requests within the TTL:

  ```
  [PromptCache] prompt=1500 completion=180 cache_creation=0 cache_read=1024
  [PromptCache] Cache HIT — 1024 tokens read from cache
  ```

  Logs are written to n8n's standard logger (visible in Docker/container stdout).

  ### Tool Search

  Tool Search enables Claude to dynamically discover and load tools on-demand from a large catalog. Instead of sending all tool definitions upfront, tools are marked as deferred and Claude searches for the ones it needs.

  To enable Tool Search:

  1. Set the **Base URL** to your LiteLLM proxy endpoint
  2. Enable **Enable Tool Search** in the Options
  3. Optionally change the **Tool Search Variant** (default: Regex)

  #### How it works

  When Tool Search is enabled, the node:

  - Injects a tool search tool (`tool_search_tool_regex` or `tool_search_tool_bm25`) into the request
  - Marks all connected tools with `defer_loading: true` so they are loaded on-demand
  - LiteLLM automatically adds the required `anthropic-beta: advanced-tool-use-2025-11-20` header

  Claude then searches for relevant tools using regex patterns (Regex variant) or natural language queries (BM25 variant) before calling them.

  #### Variants

  | Variant | Description | Availability |
  |---------|-------------|--------------|
  | **Regex** | Claude constructs regex patterns to search tools by name, description, and arguments. Faster. | All providers |
  | **BM25** | Claude uses natural language queries for semantic tool matching. Better for large catalogs. | Not available on Bedrock |

  #### Monitoring

  When Tool Search is enabled, the node logs injection activity:

  ```
  [ToolSearch] Injected tool_search_tool_regex + defer_loading on 5 tools
  ```

  The LiteLLM response usage will also include `tool_search_requests` count.

  #### Requirements

  - A LiteLLM proxy configured with a Claude model via Vertex AI, Bedrock, or direct Anthropic API
  - At least one tool connected to the agent

  ## Options

  | Option | Description | Default |
  |--------|-------------|---------|
  | Base URL | Override the API endpoint (e.g., LiteLLM proxy) | `https://api.openai.com/v1` |
  | Enable Prompt Caching | Inject LiteLLM cache control headers and injection points | `false` |
  | Cache TTL | Cache duration: 5 Minutes or 1 Hour | `5 Minutes` |
  | Enable Tool Search | Enable Anthropic Tool Search for dynamic tool discovery | `false` |
  | Tool Search Variant | Regex (pattern matching) or BM25 (semantic search) | `Regex` |
  | Frequency Penalty | Penalize repeated tokens (-2 to 2) | `0` |
  | Maximum Number of Tokens | Max tokens to generate | `-1` (unlimited) |
  | Max Retries | Number of retry attempts | `2` |
  | Presence Penalty | Penalize new topic tokens (-2 to 2) | `0` |
  | Reasoning Effort | For o-series/gpt-5 models: low, medium, high | `medium` |
  | Response Format | Text or JSON mode | `text` |
  | Sampling Temperature | Controls randomness (0 to 2) | `0.7` |
  | Timeout | Request timeout in milliseconds | `300000` |
  | Top P | Nucleus sampling threshold (0 to 1) | `1` |

  ## Development

  ```bash
  npm install
  npm run build
  ```

  ## License

  MIT

ai_documentation_summary:
  {"purpose":"An n8n community node that extends the built-in OpenAI Chat Model to support non-OpenAI models and advanced features like prompt caching and tool search via LiteLLM proxies.","capabilities":["Prompt caching via LiteLLM to reduce costs and latency","Configurable cache TTL (5 minutes or 1 hour)","Cache usage logging in n8n logs","Anthropic Tool Search for dynamic tool discovery","Regex or BM25 tool search variants","Base URL override for LiteLLM or other OpenAI-compatible proxies","Dynamic model list retrieval from API endpoint","Standard ChatOpenAI options (temperature, top P, penalties, max tokens, response format, reasoning effort, timeout, retries)"],"authentication":"API key required (reuses built-in openAiApi credential)","commonUseCases":["Reducing costs and latency for repeated system prompts using LiteLLM caching","Enabling dynamic tool discovery for Anthropic models with large tool catalogs","Supporting non-OpenAI models proxied through LiteLLM (e.g., Anthropic, Vertex AI, Bedrock)","Monitoring cache hits/writes/misses in n8n logs"],"limitations":["Prompt caching requires system prompts of at least 1024 tokens for Anthropic models","BM25 tool search variant is not available on Bedrock","Cache usage and tool search activity are logged to n8n's standard logger (visible in Docker/container stdout)","Requires a LiteLLM proxy configured with the appropriate model for advanced features"],"relatedNodes":["OpenAI Chat Model","AI Agent","Chain"]}


node_type: n8n-nodes-minio.minio
package_name: n8n-nodes-minio
display_name: minio
description: n8n custom nodes for Minio
category: Community
development_style: declarative
version: 0.1.4
properties_schema: []
operations: []
credentials_required: []
updated_at: 2026-04-16 09:43:37
author_name: cedricziel
author_github_url: git+https://github.com/cedricziel/n8n-nodes-minio.git
npm_package_name: n8n-nodes-minio
npm_version: 0.1.4
community_fetched_at: 2026-04-16T09:43:37.383Z
ai_summary_generated_at: 2026-03-25 22:47:20
npm_readme:
  # n8n-nodes-minio

  This is an n8n community node. It lets you use the minio client library in your n8n workflows.

  The primary motivation was to create an easy way to create pre-signed URLs easily.

  [n8n](https://n8n.io/) is a [fair-code licensed](https://docs.n8n.io/reference/license/) workflow automation platform.

  [Installation](#installation)  
  [Operations](#operations)  
  [Credentials](#credentials)  <!-- delete if no auth needed -->  
  [Compatibility](#compatibility)  
  [Usage](#usage)  <!-- delete if not using this section -->  
  [Resources](#resources)  

  ## Installation

  Follow the [installation guide](https://docs.n8n.io/integrations/community-nodes/installation/) in the n8n community nodes documentation.

  ## Operations

  ### Objects

  * `presignedGetObject` - create a presigned URL for an object
  * `presignedPutObject` - create a presigned upload URL for an object
  * `removeObject` - remove an object

  ## Credentials

  To use the minio credentials, you'll need to provide the following:

  * Access Key
  * Secret Key
  * Endpoint

  ## License

  [MIT](./LICENSE.md)

ai_documentation_summary:
  {"purpose":"This n8n community node enables interaction with Minio object storage, primarily for generating pre-signed URLs and managing objects.","capabilities":["Create presigned GET URLs for object download","Create presigned PUT URLs for object upload","Remove objects from storage"],"authentication":"API key required (Access Key and Secret Key)","commonUseCases":["Secure object download via time-limited URLs","Secure object upload via time-limited URLs","Object cleanup and deletion workflows"],"limitations":["Limited to basic object operations (no list, head, or copy operations mentioned)","Community node (may require manual installation)"],"relatedNodes":["n8n-nodes-webhook","n8n-nodes-http-request","n8n-nodes-s3"]}


node_type: @bitovi/n8n-nodes-excel.excel
package_name: @bitovi/n8n-nodes-excel
display_name: excel
description: N8N node to work with Excel files
category: Community
development_style: declarative
version: 0.2.1
properties_schema: []
operations: []
credentials_required: []
updated_at: 2026-04-16 09:43:37
author_name: bitovi-os
author_github_url: git+https://github.com/bitovi/n8n-nodes-excel.git
npm_package_name: @bitovi/n8n-nodes-excel
npm_version: 0.2.1
community_fetched_at: 2026-04-16T09:43:37.384Z
npm_readme:
  # @bitovi/n8n-nodes-excel

  This repo contains [N8N](https://n8n.io/) node to work with Excel files.

  ## Installation

  - Make sure to allow community nodes with `N8N_COMMUNITY_PACKAGES_ENABLED=true`
  - Once logged in to your N8N web UI, go to `/settings/community-nodes` and type `@bitovi/n8n-nodes-excel`

  ## Need help or have questions?

  Need guidance on leveraging AI agents or N8N for your business? Our [AI Agents workshop](https://hubs.ly/Q02X-9Qq0) will equip you with the knowledge and tools necessary to implement successful and valuable agentic workflows.

  ## License

  [MIT](./LICENSE.md)


node_type: n8n-nodes-highlevelv2.highlevelv2
package_name: n8n-nodes-highlevelv2
display_name: highlevelv2
category: Community
development_style: declarative
version: 1.0.16
properties_schema: []
operations: []
credentials_required: []
updated_at: 2026-04-16 09:43:37
author_name: marioaldayuz
author_github_url: git+https://github.com/marioaldayuz/n8n-highlevel.git
npm_package_name: n8n-nodes-highlevelv2
npm_version: 1.0.16
community_fetched_at: 2026-04-16T09:43:37.385Z
description:
  n8n community node for HighLevel v2 API integration - comprehensive CRM, marketing automation, and business management platform

npm_readme:
  # n8n-nodes-highlevelv2 (BETA)

  This is an n8n community node that provides **comprehensive integration** with the HighLevel API v2, featuring **30 resources** with **100+ operations**. It allows you to seamlessly connect your n8n workflows with HighLevel's powerful CRM, marketing automation, and business management platform.

  Get your 30 Day FREE Trial of [HighLevel](https://www.gohighlevel.com/marioaldayuz) by clicking [HERE](https://www.gohighlevel.com/marioaldayuz)!

  [HighLevel](https://www.gohighlevel.com/marioaldayuz) is an all-in-one business platform that combines CRM, marketing automation, website building, funnel creation, appointment scheduling, and more into a single unified system.

  [n8n](https://n8n.io/) is a [fair-code licensed](https://docs.n8n.io/reference/license/) workflow automation platform.

  ## Table of Contents

  [Installation](#installation)  
  [Resources & Operations](#resources--operations)  
  [Credentials](#credentials)  
  [Compatibility](#compatibility)  
  [Features](#features)  
  [Usage Examples](#usage-examples)  
  [Testing](#testing)  
  [Development](#development)  
  [Resources](#resources)  

  ## 🚀 Full Feature Overview

  This comprehensive n8n community node provides complete coverage of the HighLevel API v2 with:

  ### **30 Core Resources**
  Auth • Blog • Business • Calendar • Calendar Event • Calendar Group • Calendar Resource • Contact • Conversation • Coupon • Custom Field • Custom Objects • Custom Values • Email • Form • Funnel • Media • Notes • Appointment Notes • Object Associations • Opportunity • Product • Redirect • SaaS • Social Planner • Sub-Account • Survey • Task • Tags • User

  ### **100+ Operations** Including:
  - **Full CRUD Operations** across all resources
  - **Advanced Search & Filtering** with pagination
  - **Bulk Operations** for efficiency
  - **File Management** (upload, organize, delete)
  - **Relationship Management** (object associations)
  - **Marketing Automation** (email templates, social posts, funnels)
  - **E-commerce Features** (products, coupons, redirects)
  - **Business Management** (sub-accounts, users, SaaS)
  - **CRM Features** (contacts, conversations, notes, tags)
  - **Analytics & Reporting** (social analytics, funnel metrics)

  ### **Advanced Features**
  - 🔄 **Automatic Pagination** for large datasets
  - 🏷️ **Dynamic Custom Fields** with live search
  - 🌍 **Timezone Management** with location awareness
  - 📧 **Email/Phone Validation** with format checking
  - 🔗 **Location-aware Operations** with automatic context injection
  - 🎯 **Flexible Tag Processing** (comma-separated or array formats)
  - 📁 **File Upload Support** with metadata management
  - ⚡ **Comprehensive Error Handling** with detailed responses
  - 🔍 **Advanced Search Capabilities** across multiple resources

  ## Installation

  Simply go to N8N Settings > Community Nodes > Install > `n8n-nodes-highlevelv2` and you're off to the races!

  ## Resources & Operations

  This node provides access to the following HighLevel resources and operations:

  ### 🔐 Authentication
  - **Get Location Access Token**: Retrieve location-specific access tokens for API operations

  ### 📝 Blog Management
  - **Create**: Create new blog posts
  - **Update**: Modify existing blog posts
  - **Get**: Retrieve specific blog posts
  - **Get All**: List all blog posts
  - **Delete**: Remove blog posts

  ### 🏢 Business Management
  - **Create**: Create new businesses with complete contact information
  - **Get**: Retrieve specific business details and contact information
  - **Get Many**: List multiple businesses with filtering and search capabilities
  - **Update**: Modify existing business information including contact details
  - **Delete**: Remove businesses from the system

  ### 📅 Calendar Management
  - **Create**: Create new calendars
  - **Get**: Retrieve specific calendar details
  - **Get Many**: List multiple calendars with filtering options
  - **Update**: Modify existing calendar information
  - **Delete**: Remove calendars from the system
  - **Get Free Slots**: Retrieve available calendar slots for scheduling

  ### 📅 Calendar Event Management  
  - **Create Appointment**: Schedule new appointments with full contact and calendar integration
  - **Update Appointment**: Modify existing appointment details, times, and status
  - **Get Appointment**: Retrieve specific appointment details by ID
  - **Create Block Slot**: Block calendar time slots to prevent bookings
  - **Update Block Slot**: Modify existing blocked time slots
  - **Get Blocked Slots**: List all blocked time slots with filtering options
  - **Delete Event**: Remove appointments or calendar events from the system

  ### 📅 Calendar Group Management
  - **Create**: Create new calendar groups to organize multiple calendars
  - **Get Many**: List all calendar groups with filtering and search capabilities
  - **Update**: Modify existing calendar group settings and assignments
  - **Delete**: Remove calendar groups from the system
  - **Disable**: Temporarily disable calendar groups
  - **Validate Slug**: Check if a calendar group slug is available for use

  ### 🔧 Calendar Resource Management
  - **Create**: Create new calendar resources like rooms, equipment, or other bookable items
  - **Get**: Retrieve specific calendar resource details by ID
  - **Get Many**: List all calendar resources with pagination and filtering
  - **Update**: Modify existing calendar resource information and settings
  - **Delete**: Remove calendar resources from the system

  ### 👥 Contact Management
  - **Create or Update**: Create new contacts or update existing ones (upsert operation)
  - **Get**: Retrieve specific contact details
  - **Get Many**: List multiple contacts with filtering options
  - **Update**: Modify existing contact information
  - **Delete**: Remove contacts from the system

  ### 💬 Conversation Management
  - **Create Conversation**: Start new conversations
  - **Get Conversation**: Retrieve conversation details
  - **Update Conversation**: Modify conversation properties
  - **Delete Conversation**: Remove conversations
  - **Send Message**: Send messages within conversations
  - **Get Messages**: Retrieve conversation messages
  - **Add Inbound Message**: Process incoming messages
  - **Add External Outbound Call**: Log external calls
  - **Cancel Scheduled Email/Message**: Cancel pending communications
  - **Upload File Attachment**: Add files to conversations
  - **Get Email/Recording/Transcription**: Retrieve communication assets
  - **Download Transcription**: Download call transcriptions
  - **Update Message Status**: Modify message delivery status
  - **Search Conversations**: Find conversations using filters

  ### 🎫 Coupon Management
  - **Create**: Create new discount coupons
  - **Get**: Retrieve specific coupon details
  - **Get Many**: List multiple coupons with filtering options
  - **Update**: Modify existing coupon information
  - **Delete**: Remove coupons from the system

  ### 🏷️ Custom Fields Management
  - **Create**: Add new custom fields
  - **Update**: Modify existing custom fields
  - **Get**: Retrieve custom field details
  - **Delete**: Remove custom fields
  - **Create Folder**: Organize custom fields in folders
  - **Get Folder**: Retrieve folder information
  - **Update Folder**: Modify folder properties
  - **Delete Folder**: Remove custom field folders

  ### 🗂️ Custom Objects Management
  - **Create Custom Object**: Define new custom object schemas
  - **Get Object Schema**: Retrieve custom object schema details
  - **Get All Objects**: List all custom objects for a location
  - **Update Object Schema**: Modify existing custom object schemas
  - **Create Record**: Add new records to custom objects
  - **Get Record**: Retrieve specific custom object records
  - **Update Record**: Modify existing custom object records
  - **Delete Record**: Remove records from custom objects
  - **Search Records**: Find records using filters and queries

  ### 📊 Custom Values Management
  - **Create**: Add new custom values with various data types
  - **Get**: Retrieve specific custom value details
  - **Get All**: List all custom values with filtering options
  - **Update**: Modify existing custom value properties
  - **Delete**: Remove custom values from the system

  ### 📧 Email Management
  - **Create Template**: Design email templates
  - **Update Template**: Modify existing templates
  - **Delete Template**: Remove email templates
  - **Get Templates**: List available templates
  - **Get Campaigns**: Retrieve email campaign data

  ### 📋 Forms Management
  - **Get Forms**: List available forms
  - **Get Form Submissions**: Retrieve form responses
  - **Upload File**: Handle form file uploads

  ### 🕳️ Funnel Management
  - **Get All Funnels**: List all funnels with filtering and search
  - **Get Funnel Pages**: Retrieve all pages within a specific funnel
  - **Get Page Count**: Get detailed count statistics for funnel pages

  ### 📁 Media Management
  - **Get List of Files**: Retrieve all files and folders in the media library
  - **Upload File**: Upload files to the media library with metadata
  - **Delete File or Folder**: Remove files or folders from the media library

  ### 📝 Notes Management
  - **Create**: Add new notes to contacts
  - **Get**: Retrieve specific note details
  - **Get All**: List all notes for a contact with pagination
  - **Update**: Modify existing note content
  - **Delete**: Remove notes from contacts

  ### 📝 Appointment Notes Management
  - **Create**: Add new appointment-specific notes to track appointment details
  - **Get Many**: List all appointment notes with filtering by contact, user, or appointment
  - **Update**: Modify existing appointment note content
  - **Delete**: Remove appointment notes from the system

  ### 🔗 Object Associations Management
  - **Create Association**: Define relationships between different object types
  - **Get Association by ID**: Retrieve association details by ID
  - **Get Association by Object Keys**: Find associations between specific objects
  - **Get Association Key by Key Name**: Retrieve association keys by name
  - **Update Association**: Modify existing association definitions
  - **Delete Association**: Remove association definitions
  - **Get All Associations**: List all associations for a location
  - **Create Relation**: Establish relations between specific object instances
  - **Get All Relations by Record ID**: Retrieve relations for specific records
  - **Delete Relation**: Remove specific object relations

  ### 🎯 Opportunity Management
  - **Create**: Add new opportunities
  - **Update**: Modify opportunity details
  - **Get**: Retrieve specific opportunities
  - **Get All**: List multiple opportunities

  ### 🛍️ Product Management
  - **Create**: Add new products to inventory
  - **Get**: Retrieve specific product details
  - **Get Many**: List multiple products with filtering options
  - **Update**: Modify existing product information
  - **Delete**: Remove products from inventory
  - **Bulk Update**: Update multiple products at once

  ### 🔀 Redirect Management
  - **Create**: Create new URL redirects (301/302)
  - **Get All**: List all redirects with filtering options
  - **Update**: Modify existing redirect rules
  - **Delete**: Remove redirects from the system

  ### 🏢 SaaS Management
  - **Enable SaaS**: Activate SaaS features for locations
  - **Disable SaaS**: Deactivate SaaS features
  - **Bulk Enable SaaS**: Enable SaaS for multiple locations
  - **Get SaaS Locations**: List SaaS-enabled locations
  - **Get SaaS Plan**: Retrieve plan information
  - **Get Agency Plans**: List available agency plans
  - **Get Location Subscription Details**: Retrieve subscription info
  - **Get Locations by Stripe ID**: Find locations by payment ID
  - **Update Subscription**: Modify subscription settings
  - **Update Rebilling**: Adjust billing configurations
  - **Pause Location**: Temporarily suspend location access

  ### 📱 Social Planner Management
  - **Create Post**: Create social media posts
  - **Schedule Post**: Schedule posts for later publication
  - **Get Posts**: Retrieve social media posts
  - **Get Post**: Get a specific social media post
  - **Update Post**: Update existing social media posts
  - **Delete Post**: Delete social media posts
  - **Get Social Accounts**: List connected social accounts
  - **Get Analytics**: Retrieve social media analytics and performance data

  ### 🏢 Sub-Account Management
  - **Create Sub-Account**: Add new sub-accounts
  - **Get Sub-Accounts**: List sub-accounts
  - **Create User**: Add users to sub-accounts
  - **Get Users**: List sub-account users

  ### 📊 Survey Management
  - **Get Surveys**: List available surveys
  - **Get Survey Submissions**: Retrieve survey responses

  ### ✅ Task Management
  - **Create**: Add new tasks to the system
  - **Get**: Retrieve specific task details
  - **Get Many**: List tasks for a contact
  - **Update**: Modify existing tasks
  - **Delete**: Remove tasks
  - **Search**: Search tasks with advanced filters

  ### 🏷️ Tags Management
  - **Add Tags**: Add multiple tags to contacts
  - **Remove Tags**: Remove specific tags from contacts

  ### 👤 User Management
  - **Create User**: Add new users
  - **Get User**: Retrieve user details
  - **Get Users by Location**: List users for specific locations
  - **Update User**: Modify user information
  - **Delete User**: Remove users from the system

  ## Credentials

  This node uses OAuth2 authentication with the HighLevel API. You'll need to:

  1. **Create a HighLevel App**: Register your application in the HighLevel Developer Portal
  2. **Get OAuth2 Credentials**: Obtain your Client ID and Client Secret
  3. **Configure Authentication**: Set up OAuth2 credentials in n8n with:
     - Client ID
     - Client Secret
     - Authorization URL: `https://marketplace.leadconnectorhq.com/oauth/chooselocation`
     - Access Token URL: `https://services.leadconnectorhq.com/oauth/token`
     - Scope: As required by your use case

  The node automatically handles location-specific token management and API versioning.

  ## Compatibility

  - **Minimum n8n version**: 1.0.0
  - **Node.js version**: >=20.15
  - **API Version**: HighLevel API v2 (2021-07-28)

  ## Features

  ### 🔧 Core Functionality
  - **30 Resource Types**: Complete coverage of HighLevel API v2
  - **100+ Operations**: Full CRUD operations across all resources
  - **Advanced Search**: Powerful filtering and search capabilities
  - **Bulk Operations**: Efficient handling of multiple records
  - **Real-time Data**: Live integration with HighLevel platform

  ### 🚀 Advanced Automation
  - **Automatic Pagination**: Seamlessly handles large datasets
  - **Location-aware Operations**: Automatic location context injection
  - **Dynamic Field Mapping**: Smart custom field integration with live search
  - **Timezone Management**: Automatic timezone handling and conversion
  - **Email/Phone Validation**: Built-in format validation and verification
  - **Tag Processing**: Flexible tag management (comma-separated or array formats)
  - **File Upload Support**: Handle attachments in conversations, forms, and media library
  - **Error Handling**: Comprehensive error handling with detailed reporting

  ### 📊 Data Management
  - **Custom Objects & Fields**: Create and manage custom data structures
  - **Object Associations**: Define relationships between different data types
  - **Custom Values**: Typed custom values with categories and organization
  - **Media Library**: Complete file and folder management
  - **Notes & Tags**: Rich contact annotation and categorization

  ### 🎯 Marketing & Sales
  - **Contact Management**: Complete CRM with custom fields and validation
  - **Conversation Handling**: SMS, email, calls with file attachments
  - **Social Media Planning**: Multi-platform post creation and scheduling
  - **Email Campaigns**: Template management and campaign tracking
  - **Funnel Analytics**: Page performance and conversion tracking
  - **Product Catalog**: Inventory management with bulk operations
  - **Coupon System**: Discount management with usage tracking

  ### 🏢 Business Operations
  - **Sub-Account Management**: Multi-location business support
  - **User Administration**: Role-based access and user management
  - **SaaS Integration**: Subscription and billing management
  - **Task Management**: Project tracking with advanced search
  - **Survey Collection**: Form submission and response handling
  - **Redirect Management**: URL management and traffic routing

  ### 🔒 Security & Authentication
  - **OAuth2 Integration**: Secure token-based authentication
  - **Location Scoping**: Automatic location context for all operations
  - **API Versioning**: Consistent API version management
  - **Rate Limit Handling**: Intelligent request throttling

  ## Usage Examples

  ### Create or Update Contact
  ```javascript
  // Basic contact creation with email validation
  {
    "resource": "contact",
    "operation": "create",
    "email": "john@example.com",
    "firstName": "John",
    "lastName": "Doe",
    "phone": "+1234567890",
    "tags": "prospect,website-lead"
  }
  ```

  ### Create Calendar Resource
  ```javascript
  // Create a calendar resource (room, equipment, etc.)
  {
    "resource": "calendarResource",
    "operation": "create",
    "name": "Conference Room A",
    "additionalFields": {
      "description": "Large conference room with projector and video conferencing",
      "type": "room",
      "quantity": 1,
      "isActive": true
    }
  }
  ```

  ### Create Appointment
  ```javascript
  // Create a new appointment
  {
    "resource": "calendarEvent",
    "operation": "createAppointment",
    "calendarId": "cal_123456789",
    "contactId": "contact_123456789", 
    "startTime": "2023-12-01T10:00:00.000Z",
    "endTime": "2023-12-01T11:00:00.000Z",
    "additionalFields": {
      "title": "Sales Consultation",
      "appointmentStatus": "confirmed",
      "assignedUserId": "user_123456789",
      "address": "123 Main St, City, State 12345",
      "notes": "Initial sales consultation meeting"
    }
  }
  ```

  ### Social Media Management
  ```javascript
  // Create a social media post
  {
    "resource": "socialPlanner",
    "operation": "createPost",
    "locationId": "loc_123",
    "content": "Check out our latest offer! #sale #discount",
    "socialAccounts": ["facebook", "instagram"],
    "additionalFields": {
      "mediaUrls": "https://example.com/image1.jpg,https://example.com/image2.jpg",
      "hashtags": "sale,discount,promotion",
      "postType": "post",
      "postImmediately": true
    }
  }
  ```

  ### Create Product
  ```javascript
  // Create a new product
  {
    "resource": "product",
    "operation": "create",
    "name": "Premium T-Shirt",
    "price": 29.99,
    "description": "High-quality cotton t-shirt",
    "category": "Clothing",
    "sku": "TSHIRT-001",
    "stockQuantity": 100,
    "status": "active",
    "trackInventory": true,
    "tags": "clothing,premium,cotton",
    "weight": 0.3,
    "taxRate": 8.5
  }
  ```

  ### Notes Management
  ```javascript
  // Create a note for a contact
  {
    "resource": "notes",
    "operation": "create",
    "contactId": "contact_123",
    "body": "Follow up with customer regarding their inquiry about pricing.",
    "additionalFields": {
      "userId": "user_456"
    }
  }
  ```

  ### Tags Management
  ```javascript
  // Add tags to a contact
  {
    "resource": "tags",
    "operation": "addTags",
    "contactId": "contact_123",
    "tags": "vip,priority-follow-up,interested-in-premium",
    "additionalFields": {
      "userId": "user_456",
      "source": "workflow"
    }
  }
  ```

  ## Testing

  The node includes comprehensive test coverage for all API operations, data validation, error handling, authentication flows, and pagination functionality.

  Run tests with:
  ```bash
  npm test
  ```

  ## Development

  ### Project Structure
  ```
  nodes/HighLevelV2/
  ├── __schema__/           # JSON schemas for all operations
  ├── v2/
  │   ├── description/      # Operation descriptions
  │   ├── test/            # Test files
  │   ├── GenericFunctions.ts
  │   └── HighLevelV2.node.ts
  ├── HighLevel.node.json
  └── highLevel.svg
  ```

  ### Building
  ```bash
  npm run build
  ```

  ### Development Mode
  ```bash
  npm run dev
  ```

  ### Linting
  ```bash
  npm run lint
  npm run lintfix
  ```

  ## Resources

  - [n8n Community Nodes Documentation](https://docs.n8n.io/integrations/#community-nodes)
  - [HighLevel API Documentation](https://highlevel.stoplight.io/docs/integrations)
  - [HighLevel Developer Portal](https://marketplace.leadconnectorhq.com/)
  - [n8n Workflow Automation](https://n8n.io/)
  - [Project Repository](https://github.com/marioaldayuz/n8n-highlevel)

  ## Contributing

  This is an open-source project. Contributions are welcome! Please:

  1. Fork the repository at [https://github.com/marioaldayuz/n8n-highlevel](https://github.com/marioaldayuz/n8n-highlevel)
  2. Create a feature branch
  3. Add tests for new functionality
  4. Ensure all tests pass
  5. Submit a pull request

  ## License

  MIT License - See [LICENSE.md](LICENSE.md) for details.


node_type: n8n-nodes-discord-trigger.discordtrigger
package_name: n8n-nodes-discord-trigger
display_name: discordtrigger
description: A node that triggers a workflow whenever a message from discord is sent.
category: Community
development_style: declarative
version: 0.8.0
properties_schema: []
operations: []
credentials_required: []
updated_at: 2026-04-16 09:43:37
author_name: katerlol
author_github_url: git+https://github.com/katerlol/n8n-discord-trigger.git
npm_package_name: n8n-nodes-discord-trigger
npm_version: 0.8.0
community_fetched_at: 2026-04-16T09:43:37.386Z
ai_summary_generated_at: 2026-03-25 22:47:20
npm_readme:
  # n8n-nodes-discord-trigger

  ![n8n.io - Workflow Automation](https://raw.githubusercontent.com/n8n-io/n8n/master/assets/n8n-logo.png)

  [n8n](https://www.n8n.io) nodes to trigger workflows from Discord messages.


  This node utilizes a Discord bot to transmit or receive data from child processes when a node is executed.


  [n8n](https://n8n.io/) is a [fair-code licensed](https://docs.n8n.io/reference/license/) workflow automation platform.

  [Installation](#installation)  
  [Bot Setup](#bot-setup)  
  [Operations](#operations)  
  [Credentials](#credentials)  <!-- delete if no auth needed -->  
  [Compatibility](#compatibility)  
  [Usage](#usage)  <!-- delete if not using this section -->  
  [Version history](#version-history)  <!-- delete if not using this section -->  

  ## Installation

  Follow the [installation guide](https://docs.n8n.io/integrations/community-nodes/installation/) in the n8n community nodes documentation.


  ## Bot Setup

  To send, listen to messages, or fetch the list of channels or roles, you need to set up a bot using the [Discord Developer Portal](https://discord.com/developers/applications).

  1. Create a new application and set it up as a bot.
  2. Enable the **Privileged Gateway Intents** for Message Intent.
  3. Add the bot to your server with at least **read channel permissions**.



  ## Operations

  With this node, you can:
  - Listen to Discord chat messages (both server messages and direct messages).
  - React to messages with specific patterns or triggers.
  - Fetch lists of channels and roles.



  ## Credentials

  You need to authenticate the node with the following credentials:
  - **Client ID**: The OAuth2 client ID of the Discord App.
  - **Bot Token**: The bot token of the Discord App.
  - **n8n API Key**: The API key of your n8n server.
  - **Base URL**: The API URL of your n8n instance (e.g., `https://n8n.example.com/api/v1`).

  Refer to the [official n8n documentation](https://docs.n8n.io/) for more details.


  ## Compatibility

  - Tested on n8n version 1.75.2
  (coming soon)


  ## Usage

  To use this node:
  1. Install it as a community node in your n8n instance.
  2. Configure the required credentials.
  3. Set up triggers for Discord messages based on your use case.

  For more help on setting up n8n workflows, check the [Try it out documentation](https://docs.n8n.io/try-it-out/).


  ## Version history

  - **v0.8.0**: Add GuildMemberUpdate trigger, add option to rename confirm button choices.
  - **v0.7.0**: Add multiclient support. Multiple credentials across multiple workflows are now possible.
  - **v0.6.0**: Add direct message support (Thank you [Fank](https://github.com/Fank)) 
  - **v0.5.1**: Add additional timeout field for confirmation message
  - **v0.5.0**: Add a reaction trigger on messages, add attachments to message
  - **v0.4.0**: Introduce additional trigger options, such as User joins guild, User leaves guild, Role created, Role deleted or Role updated. 
  - **v0.3.2**: Update for multiple simultaneous trigger nodes with one bot.
  - **v0.3.1**: Added additional option to trigger node to trigger on other bot messages
  - **v0.3.0**: Added option to require a reference message in order to trigger the node. Enhance interaction node with a confirmation node
  - **v0.2.9**: Bug fix, where a message won't trigger when multiple trigger nodes are included.
  - **v0.2.8**: Multiple trigger nodes are now supported.
  - **v0.2.7**: A second node Discord Interaction is added to send a message with the same credentials. Additionally roles of users can be added or removed based on interaction.
  - **v0.1.5**: Initial release with message triggers and channel/role fetching capabilities.

ai_documentation_summary:
  {"purpose":"Triggers an n8n workflow automatically when specific events occur in a Discord server, such as messages, reactions, or user/role changes.","capabilities":["Listen to Discord chat messages (server and direct messages)","React to messages with specific patterns or triggers","Fetch lists of channels and roles","Trigger on GuildMemberUpdate events (user joins/leaves guild)","Trigger on Role created/deleted/updated events","Support multiple clients across different workflows","Require reference messages for triggering","Send confirmation messages with timeout options"],"authentication":"OAuth2 (Discord Client ID and Bot Token) + n8n API Key","commonUseCases":["Automate responses to incoming Discord messages","Monitor server activity and react to specific keywords","Automatically assign roles when users join or leave","Create automated workflows based on role changes","Fetch channel and role information for other nodes"],"limitations":["Requires Privileged Gateway Intents (Message Intent) to be enabled in Discord Developer Portal","Bot must have read channel permissions to function","Compatibility limited to n8n version 1.75.2 (as of documentation)","Community node (requires manual installation)"],"relatedNodes":["discordinteraction","discordwebhook","discordmessage"]}


node_type: n8n-nodes-better-ai-agent.betteraiagent
package_name: n8n-nodes-better-ai-agent
display_name: betteraiagent
description: A better AI Agent node for n8n with improved memory management and modern AI SDK integration
category: Community
development_style: declarative
version: 1.6.16
properties_schema: []
operations: []
credentials_required: []
updated_at: 2026-04-16 09:43:37
author_name: fjrdomingues
npm_package_name: n8n-nodes-better-ai-agent
npm_version: 1.6.16
community_fetched_at: 2026-04-16T09:43:37.387Z
ai_summary_generated_at: 2026-03-25 22:47:20
npm_readme:
  # Better AI Agent for n8n

  An improved AI Agent node for n8n that provides better memory management, modern AI SDK integration and a webhook option to push intermediate messages as they happen.

  ## Features

  - **Conversation Memory that includes Tools** – every user message, tool call and tool result is stored.
  - **Modern AI SDK Providers** – wraps OpenAI (including GPT-5), Gemini and Anthropic through stable Vercel AI SDK v4.
  - **Live Streaming Updates**: Intermediate Webhook URL lets you push each agent step in real-time

  ## Installation

  ```bash
  npm install n8n-nodes-better-ai-agent
  ```

  ## Compatibility

  This node is designed to be a drop-in replacement for the existing AI Agent node while providing enhanced functionality:

  - ✅ Works with existing Language Model nodes
  - ✅ Works with existing Memory nodes  
  - ✅ Works with existing Tool nodes
  - ✅ Works with existing Output Parser nodes
  - ✅ Maintains same input/output interface

  ## Key Improvements Over Standard Agent

  ### 1. Memory Management
  - **Problem**: Original agent doesn't save tool calls to memory
  - **Solution**: Every interaction (human messages, AI responses, tool calls, tool results) is properly saved

  ### 2. Modern AI SDK
  - **Problem**: Uses deprecated LangChain patterns
  - **Solution**: Built on Vercel AI SDK for better performance and reliability

  ### 3. Simplified Configuration
  - **Problem**: Complex agent type selection with lots of conditional logic
  - **Solution**: Single, powerful agent that adapts to your needs

  ## Usage

  ### Basic Setup

  1. **Add the node** to your workflow
  2. **Connect a Language Model** (OpenAI, Anthropic, etc.)
  3. **Optionally connect**:
     - Memory node for conversation persistence
     - Tool nodes for enhanced capabilities
     - Output Parser for structured responses

  ### Input Sources

  Choose how to provide the user prompt:

  - **Connected Chat Trigger Node**: Automatically uses `chatInput` from chat triggers
  - **Define below**: Use expressions or static text

  ### Configuration Options

  - **System Message**: Define the agent's behavior and personality
  - **Max Tool Calls**: Limit the number of tool interaction rounds
  - **Intermediate Webhook URL**: Send each partial reply/tool-call to an external workflow in real-time
  - **Verbose Logs**: Enable/disable detailed console logging
  - **Temperature**: Control response creativity (0.0 = deterministic, 1.0 = creative)
  - **Max Tokens**: Set response length limits

  ### Example Workflow

  ```
  Chat Trigger → Better AI Agent → Response
                ↗ OpenAI Model
                ↗ Buffer Memory
                ↗ Calculator Tool
                ↗ Web Search Tool
  ```

  ## Technical Details

  ### Tool Call Memory

  Unlike the original agent, this node ensures that all tool interactions are preserved in memory:

  ```
  User: "What's 25 * 47 and then search for that number"
  Assistant: [calls calculator tool]
  Tool: "1175"
  Assistant: [calls web search tool with "1175"]
  Tool: [search results]
  Assistant: "The result is 1175. Here's what I found about it..."
  ```

  All of these interactions are saved to memory for future reference.

  ### AI SDK Integration

  Uses modern patterns from Vercel AI SDK:

  - Built-in tool calling support
  - Automatic conversation management
  - Better error handling
  - Real-time step streaming via `onStepFinish`

  ### Known Limitations

  | Limitation | Work-around |
  |------------|------------|
  | n8n UI does not highlight the attached model or tool nodes because only the Agent executes code | Rely on the Agent output or streamed webhook messages for visibility |
  | Tool nodes without an explicit Zod/JSON schema (e.g. raw HTTP Request) may receive incorrect argument keys | Wrap such tools in a **Custom Code Tool** and define a schema, or add few-shot examples |
  | Streaming is step-level, not token-level; the n8n node outputs only when the Agent finishes | Use the Intermediate Webhook to push interim messages to a Chat, Slack, etc. |
  | The node's dependencies must be available next to `~/.n8n/custom/BetterAiAgent.node.js` | Run `npm run deploy-local` (copies `package.json` and installs runtime deps) |

  ## Development

  ### Building from Source

  ```bash
  git clone <repository>
  cd better-ai-agent
  npm install
  npm run build
  ```

  ### Testing

  ```bash
  npm test
  ```

  ### Publishing

  ```bash
  npm run package
  npm publish
  ```

  ## Troubleshooting

  ### Common Issues

  1. **"No language model connected"**: Ensure you've connected a language model node
  2. **Tool calls not working**: Verify your tools are properly configured and connected
  3. **Memory not persisting**: Check that your memory node is correctly connected

  ### Debug Information

  The node outputs additional debug information:

  - `usage`: Token usage statistics
  - `finishReason`: Why the generation stopped
  - `toolCalls`: List of tools that were called
  - `toolResults`: Results from tool executions

  ## Contributing

  We welcome contributions! Please see our contributing guidelines for more information.

  ## License

  MIT License - see LICENSE file for details.

  ## Support

  - Create an issue for bugs or feature requests
  - Join the n8n community for general support
  - Check the documentation for detailed usage examples 

ai_documentation_summary:
  {"purpose":"A n8n node that provides an improved AI Agent with enhanced memory management for tool calls, modern Vercel AI SDK integration, and real-time streaming updates.","capabilities":["Stores conversation history including tool calls and results","Integrates with OpenAI, Gemini, and Anthropic via Vercel AI SDK v4","Supports live streaming of intermediate agent steps via webhook","Adapts to different agent needs with a single powerful agent configuration","Outputs debug information including token usage, finish reason, tool calls, and tool results","Supports custom system messages and temperature control"],"authentication":"None","commonUseCases":["Replacing the standard AI Agent node with enhanced memory features","Building chatbots that need to track tool interactions across conversations","Streaming partial agent responses to external channels like Slack or Chat","Integrating with existing Language Model, Memory, and Tool nodes"],"limitations":["n8n UI does not highlight attached model or tool nodes (only the Agent executes code)","Tool nodes without explicit Zod/JSON schemas may receive incorrect argument keys","Streaming is step-level rather than token-level","Node dependencies must be installed locally using npm run deploy-local"],"relatedNodes":["Language Model","Memory","Tool","Output Parser","Chat Trigger"]}


node_type: @splainez/n8n-nodes-phonenumber-parser.phonenumberparser
package_name: @splainez/n8n-nodes-phonenumber-parser
display_name: phonenumberparser
description: Parse a phone number and return its information
category: Community
development_style: declarative
version: 1.2.0
properties_schema: []
operations: []
credentials_required: []
updated_at: 2026-04-16 09:43:37
author_name: splainez
author_github_url: git+https://github.com/splainez/n8n-nodes-phonenumber-parser.git
npm_package_name: @splainez/n8n-nodes-phonenumber-parser
npm_version: 1.2.0
community_fetched_at: 2026-04-16T09:43:37.388Z
ai_summary_generated_at: 2026-03-25 22:47:20
npm_readme:
  # n8n-nodes-phonenumber-parser

  [![version](https://img.shields.io/npm/v/@splainez/n8n-nodes-phonenumber-parser.svg)](https://www.npmjs.org/package/@splainez/n8n-nodes-phonenumber-parser)

  ## Description

  The `PhoneNumberParser` node is a powerful tool for working with phone numbers in your n8n workflows. It uses the `libphonenumber-js` library to format phone numbers into human-readable formats and extract useful information, such as the country code, area code, and phone number.


  You can also clone the repository from GitHub and build the package yourself.

  ## Installation

  Follow the [installation guide](https://docs.n8n.io/integrations/community-nodes/installation/) in the n8n Community Nodes documentation.

  ## Usage

  To use the `PhoneNumberParser` node in your n8n workflows, drag and drop the node from the node palette onto your workflow canvas. Then, connect the output of any preceding node to the input of the `PhoneNumberParser` node.

  The `PhoneNumberParser` node has a single input parameter: the phone number to be formatted. This should be a string containing only digits. Once the node receives the phone number, it will automatically format it into a human-readable format and extract useful information, such as the country code, area code, and phone number. The formatted phone number will be output as a JSON object containing these fields.

  This node parses a phone number using the `libphonenumber-js` library and returns its information in JSON format. The following information is included in the output:

  * `country`: The country code associated with the phone number.
  * `countryCallingCode`: The country calling code of the phone number.
  * `nationalNumber`: The national (significant) part of the phone number.
  * `formatNational`: The phone number formatted in national format.
  * `formatInternational`: The phone number formatted in international format.
  * `formatE164`: The phone number formatted in E.164 format.
  * `formatRFC3966`: The phone number formatted in RFC3966 format.
  * `possible`: Whether the length of the phone number is valid, although it may not necessarily be correctly formatted.
  * `valid`: Whether the phone number is valid, based on both length and format.
  * `nonGeographic`: Whether the phone number is non-geographic (i.e., not tied to a specific location).
  * `type`: The type of phone number (e.g., FIXED_LINE_OR_MOBILE, MOBILE, FIXED_LINE, TOLL_FREE, etc.).


  ## License

  This project is licensed under the MIT License. See the `LICENSE` file for more details.

  This project uses the `libphonenumber-js` library, which is also licensed under the MIT License. See the `libphonenumber-js/LICENSE` file for more details.

ai_documentation_summary:
  {"purpose":"The PhoneNumberParser node parses phone numbers using the libphonenumber-js library to extract metadata and format them into various human-readable standards.","capabilities":["Extract country code","Extract area code","Extract national number","Format phone number in national format","Format phone number in international format","Format phone number in E.164 format","Format phone number in RFC3966 format","Validate phone number length","Validate phone number format","Determine if number is non-geographic"],"authentication":"None","commonUseCases":["Standardizing phone number formats across workflow outputs","Validating user-provided phone numbers before processing","Extracting country codes for routing or display purposes","Normalizing phone numbers for database storage"],"limitations":["Input must be a string containing only digits"],"relatedNodes":["httprequest","json","string","if"]}


