> ## Documentation Index
> Fetch the complete documentation index at: https://partner-integrations.voyado.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Crobox

This integration enables the enrichment of contact profiles in Voyado Engage. The enrichment is based on the customer's interactions with a product finder that is provided by Crobox. The integration allows for:

* seamless syncing of user responses
* creation or updating of contacts
* personalization of follow-up communication.

<Tip>
  Contact your account manager at Voyado to activate this integration with Crobox. You will need to have Incentives as part of your license model to use the feature.
</Tip>

You will need to contact Crobox too if you haven't already signed with them yet sicne most of the setup is done in their tool.

<Card title="Contact Crobox to sign up" href="mailto:sales@crobox.com)" icon="envelope" horizontal />

## Setup and configuration in Engage

Here are the configuration steps:

<Steps>
  <Step title="Enable Interations">
    Contact your Voyado AM  to enable interactions and to be assigned a representative who will help you with the implementation.
  </Step>

  <Step title="Decide on datapoints">
    Define which datapoints you wish to use in Engage through the Crobox integration. This will be discussed together with Crobox and Voyado, to create a setup tailored to your needs.
  </Step>

  <Step title="Create API key">
    An Engage API key is needed for this integration. Create this yourself via Config Hub:

    <Card title="See how to create API keys in Config Hub" href="https://help.engage.voyado.com/hc/en-gb/articles/23405185859228-API-connections" icon="https://mintcdn.com/voyado-partners/0IxEIB2Y6a--gNYY/icons/help-center-link.png?fit=max&auto=format&n=0IxEIB2Y6a--gNYY&q=85&s=4e7f518f776580d7cdae461a964ea2dc" horizontal width="128" height="128" data-path="icons/help-center-link.png" />

    <Warning>
      You will need to be in permissions group "Configurator" to be able to create API keys.
    </Warning>
  </Step>

  <Step title="Provide client ID">
    Now you'll need to send your Engage client ID to Crobox. It's the *tenantname* part of the URL:

    ```http theme={null}
    http://[tenantname].voyado.com
    ```
  </Step>
</Steps>

## Setup and configuration in Crobox

<Tip>
  Contact Crobox if you have any questions related to the setup.
</Tip>

A standard webhook integration exists for any client to use. Here the interaction schema ID from your Engage environment can be set, together with the `Client_id` and `Api_key` values.

Here is what the interface looks like in Crobox:

<Frame caption="The Crobox interface">
  <img src="https://mintcdn.com/voyado-partners/sqCq4GljyUAtRgD1/images/crobox/crobox-01.png?fit=max&auto=format&n=sqCq4GljyUAtRgD1&q=85&s=5bf033145e131e020079c3b51fea5378" alt="The Crobox interface" width="1145" height="733" data-path="images/crobox/crobox-01.png" />
</Frame>

In the finder setup, you can map questions, product properties and other custom properties to the Voyado interaction schema's fields. Your contact will be enriched with the answers given in the finder, which products were suggested (URL, images, benefits, or any other product property), and in what language the visitor was engaging.

<Frame caption="Mapping of properties">
  <img src="https://mintcdn.com/voyado-partners/sqCq4GljyUAtRgD1/images/crobox/crobox-02.png?fit=max&auto=format&n=sqCq4GljyUAtRgD1&q=85&s=e9885f5eaaea8e72650a97fe514c426e" alt="ALT text" width="438" height="782" data-path="images/crobox/crobox-02.png" />
</Frame>

<Frame caption="Mapping of properties">
  <img src="https://mintcdn.com/voyado-partners/sqCq4GljyUAtRgD1/images/crobox/crobox-03.png?fit=max&auto=format&n=sqCq4GljyUAtRgD1&q=85&s=88371f60e74effa7351539c7ec24b32b" alt="ALT text" width="469" height="710" data-path="images/crobox/crobox-03.png" />
</Frame>

## Personalized content

In order to add content from the product finder to a send-out in Engage, use the schema ID like this:

```bash theme={null}
[[croboxproductfinder.XYZ]]
```

Where you have replaced XYZ with the value saved in `Property Key` in Crobox.

More Personalization examples can be found here:

<Card title="Read about personalization using interactions" href="https://help.engage.voyado.com/hc/en-gb/articles/17234930140572-Personalize-email-and-SMS-using-interactions" icon="https://mintcdn.com/voyado-partners/0IxEIB2Y6a--gNYY/icons/help-center-link.png?fit=max&auto=format&n=0IxEIB2Y6a--gNYY&q=85&s=4e7f518f776580d7cdae461a964ea2dc" horizontal width="128" height="128" data-path="icons/help-center-link.png" />
