Kipps.AI Chatbot icon

Kipps.AI Chatbot

Interact with a Kipps.AI Chatbot to send and receive messages.

Overview

This node allows you to interact with a Kipps.AI Chatbot by sending messages and receiving replies. It is useful for automating conversations with a chatbot agent, enabling integration of AI-driven chat capabilities into workflows. Typical use cases include customer support automation, interactive FAQs, or any scenario where conversational AI can assist users.

For example, you can send a greeting message to a specific chatbot agent and receive its response, optionally maintaining the conversation context across multiple messages by using a session ID.

Properties

Name Meaning
Agent ID The unique identifier of the chatbot agent you want to communicate with (e.g., "chatbot-123").
Message The text message you want to send to the chatbot.
Session ID An optional identifier to maintain conversation context. If left empty, a new session is created automatically.

Output

The node outputs JSON data containing the chatbot's reply. The structure corresponds directly to the API response from Kipps.AI and includes the chatbot's message and related metadata.

Example output JSON structure:

{
  "id": "conversation-session-id",
  "reply": "Chatbot's response message",
  ...
}

If an error occurs during the request, and the node is configured to continue on failure, the output will contain an error field with the error message and details.

Dependencies

  • Requires an active Kipps.AI API key credential configured in n8n.
  • Makes HTTP POST requests to the Kipps.AI backend endpoints:
    • To create or retrieve a conversation session: https://backend.kipps.ai/v2/kipps/conversation/
    • To send a message and get a reply: https://backend.kipps.ai/v2/kipps/reply/

Troubleshooting

  • Common issues:

    • Missing or invalid Agent ID or API credentials will cause authentication errors.
    • Network connectivity problems may prevent reaching the Kipps.AI backend.
    • Providing an invalid or expired session ID might result in unexpected conversation behavior.

  • Error messages:

    • Errors returned from the API are captured and can be output if "Continue On Fail" is enabled.
    • Typical errors include authentication failures, invalid parameters, or server errors.

  • Resolution tips:

    • Verify that the Agent ID is correct and corresponds to an existing chatbot agent.
    • Ensure the API key credential is properly set up and has necessary permissions.
    • Check network access and firewall settings.
    • Use valid session IDs or leave empty to start fresh sessions.

Links and References

Discussion