The best way to data to Tellescope is using custom code in an Action, that is Triggered when a user takes an action, such as entering their email or completing a purchase.

1

Create a custom code Action

  • Go to the Logic sidebar and click on the Actions tab.
  • Click + Add New Action.
  • Give it a name like “Send Data to Tellescope”.
  • Hit Add.
2

Write your custom code

  • Add code similar to the example below, to construct the data object and send it to Tellescope’s API.
function output(userData, context) {
  const tellescopeData = {
    answers: [
      {
        key: "first_name",
        value: userData.first_name,
      },
      {
        key: "last_name",
        value: userData.last_name,
      },
      {
        key: "phone",
        value: userData.phone,
      },
      {
        key: "email",
        value: userData.email,
      },
      // Add any other user data properties that you want to send to Tellescope here
    ],
    variant_label: "main",
    variant_uuid: "<VARIANT_UUID>",
    finalized: true,
    created_at: generateFormattedDate(),
    experiment_uuid: null,
    flow_label: "<FLOW_LABEL>",
  };
  
  // @TODO: Replace with your actual company name,
  // and provide the API key to Embeddables to store securely on the backend
  const API_KEY_IDENTIFIER = "{{YOUR_COMPANY_NAME---tellescope---api_key}}";
  const formId = "<FORM_ID>";
  const endpoint = `https://api.tellescope.com/v1/webhooks/formsort/${API_KEY_IDENTIFIER}?formId=${formId}`;

  // Send POST request, using the Embeddables backend proxy to avoid CORS issues
  fetch(
    `https://proxy-secure.trysavvy.com/?url=${encodeURIComponent(endpoint)}`,
    {
      method: "POST",
      headers: {
        "Content-Type": "application/json",
      },
      body: JSON.stringify(tellescopeData),
    }
  );
}

function generateFormattedDate() {
  const date = new Date();
  const isoString = date.toISOString();
  return isoString.replace("Z", "+00:00");
}
3

Add a Trigger for the relevant user event

  • Switch to the Triggers tab.
  • Add a new Trigger.
  • Choose the event that you want to trigger the Action on.
    • For example: WHEN Page KEY email_page IS Completed.
  • Select the Send Data to Tellescope Action.
  • Hit Add.

Learn more about Custom Code

Read more about writing Custom Code in Embeddables, including all the available arguments passed in to the function.

Was this page helpful?

Suggest editsRaise issue