Dixa Import Conversation

Imports a DigitalGenius conversation into Dixa so it appears as a natural, message-by-message dialogue (separate bubbles), rather than a single pasted transcript. Use it for offline handovers to a human agent, or to add a finished conversation to Dixa for analytics and automated quality review.

What it does

  • Takes a DigitalGenius conversation and recreates each message in Dixa as its own bubble, preserving order and timestamps.
  • Customer messages are shown as inbound (from the end user); DigitalGenius messages are shown as outbound (from the DigitalGenius Dixa bot user).
  • Automatically skips non-message events (chat start events, satisfaction-survey suppression, quick-reply buttons), so only real messages appear.
  • Looks up the customer in Dixa by email and creates them if they do not exist.
  • When Status is Open, it hands the conversation to a human queue and unassigns the bot, so Dixa can route it to an agent.
  • When Status is Closed, it imports the conversation already closed (for analytics and automated QA) and does not transfer it.
  • Requires a Dixa module connection. The DigitalGenius bot user is taken from that connection automatically.

Inputs

NameTypeDescription
ConversationObjectThe DigitalGenius conversation to import. The customer email, name, external reference and message history are read from it.
Queue IDStringThe Dixa queue to hand the conversation to a human agent. Only used when Status is Open.
StatusStringOpen (default) hands the conversation over to an agent queue. Closed imports it already closed for analytics and quality review, with no transfer.
Bot Agent IDStringThe DigitalGenius bot user in Dixa. Normally left blank, as it is taken from the connection.
Safe ModeBooleanIf true, failures are returned in the output instead of stopping the flow. Defaults to false.

Outputs

NameTypeDescription
SuccessBooleanWhether the conversation was imported successfully.
Conversation IDStringThe ID of the imported Dixa conversation.
Partial ErrorsListNon-fatal issues reported by Dixa for individual messages or the assignment.
Error MessageStringDetails of the failure when Safe Mode is enabled.


Did this page help you?