Lola Agent icon

Lola Agent

Lola Agent Hook
Join our community

Overview

The Lola Agent node is designed to send messages or interactive lists to the Lola Agent platform, which can be integrated with various chat sources such as Telegram, WhatsApp, etc. It supports sending plain text messages (with optional rephrasing/randomization) or interactive lists (up to 10 items). This node is useful for automating conversational flows, customer support bots, or any scenario where you need to programmatically interact with users via supported chat platforms.

Practical examples:

  • Sending a personalized greeting message to a user on WhatsApp.
  • Presenting an interactive list of options (e.g., menu, FAQ topics) in a Telegram chat.
  • Randomizing message phrasing for A/B testing or to avoid repetitive responses.

Properties

Name Meaning
Type The type of message to send. Options: Text (plain text message), Interactive List (a selectable list, max 10 items).
Source ID The source ID to send to Lola Agent (e.g., telegram, whatsapp, etc). Required.
Chat Identifier A unique identifier for the chat session. Required.
Message Identifier An optional identifier to track the message.
Agent Message The message content to send to Lola Agent. Required when Type is Text.
List Title The title used to detect the structure of the list. Required when Type is Interactive List.
List Header The header/title of the interactive list. Required when Type is Interactive List.
List Body The sub-title or description of the interactive list. Required when Type is Interactive List.
Interactive List Array The array of items to display in the interactive list. Must be a string or object array. Required when Type is Interactive List.
List Array String Property If using an array of objects, this property specifies which field to use as the display string. Leave empty to use the string as-is. Only shown for Interactive List.
Randomize Text Whether to rephrase the text in different ways (randomizes the outgoing message). Only available for Text messages.
Enable Cache Whether to enable caching for random phrases. Only available if Randomize Text is enabled and Type is Text.
Rephrase Text Sample Size Number of alternative phrases to generate for rephrasing. Optional; defaults to 5. Only available if Randomize Text is enabled and Type is Text.
Rephrasing Tone The tone to use for rephrasing (e.g., informal, cheerful, sarcastic, ironic, happier, etc.). Optional; defaults to "informal". Only available if Randomize Text is enabled and Type is Text.

Output

The node outputs a single item with the following structure:

{
  "lola_response": { /* Response from Lola Agent API */ }
}
  • The lola_response field contains the response returned by the Lola Agent service after sending the message or interactive list.
  • If the operation fails, an error will be thrown and no output will be produced.

Note: This node does not output binary data.

Dependencies

  • External Services: Requires access to the Lola Agent API.
  • Credentials: Optionally uses the lolaKeyApi credential if configured.
  • n8n Configuration: No special environment variables are required unless specified by your Lola Agent setup.

Troubleshooting

Common Issues:

  • Missing Required Fields: If required fields (such as Source ID, Chat Identifier, or Agent Message/List properties) are missing, the node may fail to execute.
  • Invalid List Array: For interactive lists, ensure the array is properly formatted and does not exceed 10 items.
  • Rephrasing Errors: If the NLP service cannot rephrase the message, the original text will be sent, and a log entry will indicate the failure.
  • API Errors: If the Lola Agent API returns an error, it will be logged and surfaced as a node error in n8n.

Error Messages:

  • "Error: {...}": Indicates an error occurred while sending the message. Check the error details for more information (e.g., invalid credentials, malformed payload).
  • "NLP Services can't rephrase this ...": The rephrasing service could not generate alternatives for the provided text.

How to resolve:

  • Double-check all required input fields.
  • Ensure the interactive list array is valid and within limits.
  • Verify that any credentials or API keys are correctly set up in n8n.

Links and References

  • n8n Documentation
  • Consult your Lola Agent platform documentation for specific integration details.

Discussion