Get Conversation Object Name and Email

Gets the requester name and email of a DigitalGenius conversation. Use it in Voice flows, or any flow, to read customer details stored on a conversation.

What it does

  • Gets the requester name and email from the conversation identified by the root flow ID and conversation ID.
  • Uses the current conversation when you leave Root Flow ID and Conversation ID empty.
  • Authenticates with your DigitalGenius connection, so you don't need a DG API Key and Secret.
  • Returns the name, the email, and whether the conversation has at least one of them.

Use this action to read customer details that were set earlier on a conversation. For example, Voice conversations are tied to the Call Start Flow, so use this action to read the name and email from a root flow other than the current one.

Inputs

NameTypeDescription
Root Flow IDOptional StringThe root flow ID. Leave empty to use the root flow of the current conversation. For Email and Chat flows, this is the ID of the Entry Flow. For Voice flows, this is the ID of the Call Start Flow.
Conversation IDOptional StringThe conversation ID. Leave empty to use the current execution ID.
Safe ModeOptional BooleanWhen true, the action returns Success as false with an error message instead of raising an error. Defaults to false.

Outputs

NameTypeDescription
SuccessBooleanWhether the conversation has a name or email. False when neither is set, or when Safe Mode is on and the request failed.
NameStringThe requester's name. Null when the conversation has no name or the request failed.
EmailStringThe requester's email address. Null when the conversation has no email or the request failed.
Error MessageStringWhy no name or email was returned. For example, the connection is missing, the conversation wasn't found, or the conversation has no name and email. Empty on success.

Notes

  • The action needs a DigitalGenius connection. The region comes from the connection, so the action has no Region input.
  • Success is true when the conversation has a name, an email, or both. If only one is set, the other output is null.
  • If the conversation has neither a name nor an email, the action doesn't raise an error. It returns Success as false with the error message Conversation has no name or email.
  • If the request fails, the action raises an error. For example, the request fails when the conversation isn't found. Turn on Safe Mode to handle the failure in the flow with the Success and Error Message outputs instead.
  • This action replaces the HTTP Request action with DG API Key and Secret for reading the conversation requester.
  • To update the requester name and email, use Patch Conversation Object Name and Email.

Did this page help you?