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

NameTypeRequiredDescription
ConversationObjectYesThe DigitalGenius conversation to import. The customer email, name, external reference and message history are read from it.
Queue IDStringNoThe Dixa queue to hand the conversation to a human agent. Only used when Status is Open.
StatusStringNoOpen (default) hands the conversation over to an agent queue. Closed imports it already closed for analytics and quality review, with no transfer.
Bot Agent IDStringNoThe DigitalGenius bot user in Dixa. Normally left blank, as it is taken from the connection.
Customer EmailStringNoOverrides the email read from the conversation.
Customer NameStringNoOverrides the name used if the customer has to be created.
External IDStringNoAn external reference stored on the Dixa conversation. Defaults to the conversation's own reference.
DirectionStringNoInbound or Outbound. Defaults to the direction of the first real message.
Requester Connection StatusStringNoThe connection status of the customer (Connected or Disconnected).
MessagesListNoOverrides the message list read from the conversation.
Safe ModeBooleanNoIf 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.
TransferredBooleanWhether the conversation was transferred to the queue.
ClosedBooleanWhether the conversation was imported as closed.
Partial ErrorsListNon-fatal issues reported by Dixa for individual messages or the assignment.
Error MessageStringDetails of the failure when Safe Mode is enabled.