Núcleo WondaiInstall

Summary

Prepare a conversation session by sending a hashed identifier and optional channel information to the Núcleo Wondai server, which returns whether the AI agent is allowed to proceed with the conversation and provides operational context.

Inputs

• Chave da Conversa (conversationKey) (required) — External identifier for the conversation session, typically the customer's phone number or WhatsApp remoteJid; sent only as a hash to the server.
• Canal — Communication channel of the conversation, defaulting to 'whatsapp'.
• Token ID Dinamico — Optional dynamic token from multi-tenant bootstrap, used together with the dynamic Signing Secret.
• Signing Secret Dinamico — Optional ephemeral signing secret from bootstrap; must be used with the dynamic Token ID and must not be logged.

Output shape

a JSON object payload returned from the Núcleo server indicating whether the AI is allowed to engage (allowed:true/false) and includes operational context for the conversation session

If the server returns allowed:false, treat it as a gate closed signal meaning the AI should stop and not respond. Allowed:true means normal processing with operational context for routing, memory, or LLM interaction. This operation is intended for use as the first step in a workflow before any AI or memory processing and should not be used as an AI Agent tool.

Examples

Example 1: Start a conversation on WhatsApp by preparing the session with the customer's hashed phone number as the conversation key and default channel.

Provide the conversationKey with the customer's phone number in E.164 format, optionally specify a channel like 'whatsapp', and send the request to receive a response indicating if the AI agent is enabled for this conversation session.

Links

• n8n community nodes installation guide