# Integrate with commercetools

> Talon.One supports commercetools integration via the open-source [commercetools accelerator on GitHub][repo].

> For the complete documentation index, see [llms.txt](https://docs.talon.one/llms.txt).

:::important
The [commercetools accelerator][repo] is an experimental integration method that is best suited
for use in proof-of-concept or simulation projects, not in production environments.
:::

## The commercetools accelerator

The commercetools accelerator is an open-source microservice connector
that allows you to map attributes between Talon.One and commercetools quickly.
It can be deployed from the command line.

The commercetools accelerator consists of three processes:

1. When changes in commercetools occur, customer profiles in Talon.One are updated.
1. When a customer updates the cart, event data is sent from commercetools to Talon.One.
1. Effects data is received from Talon.One and passed to your shop system through commercetools.

When the front-end of your shop system requests commercetools to make a change at the cart level,
commercetools triggers a serverless function. It passes data from commercetools
to Talon.One. At the same time, Talon.One returns data about the effects to apply to commercetools. Then commercetools returns a response to your shop system
with information about the applied effects.

## commercetools integration features

The Talon.One-commercetools integration uses an event-based architecture.
The accelerator is implemented as a set of commercetools API extensions
that are triggered by events in commercetools.

The API extensions allow you to extend the response of an API request with your own business logic. To learn more,
see the [commercetools documentation](https://docs.commercetools.com/api/projects/api-extensions).

:::note
The accelerator supports only [AWS](https://aws.amazon.com/)
and [Google Cloud Platform](https://cloud.google.com/) at the moment.
:::

## Set up the integration

The integration process consists of the following steps:

1. Set up your commercetools platform. Learn how to do this with the [commercetools docs](https://docs.commercetools.com/docs/).
1. Create an Application and a rule in the Campaign Manager. See the [Product docs](/docs/product/get-started.md).
1. Install and configure the accelerator. In [the GitHub repository][repo], see [the Readme file](https://github.com/talon-one/commercetools-talonone-accelerator#commercetools-accelerator).

### Map attributes between commercetools and Talon.One

The commercetools accelerator supports standard and custom attribute fields on both platforms.
To learn about attribute mapping, in the GitHub repository, see [the Readme file](https://github.com/talon-one/commercetools-talonone-accelerator#mapping-attributes-between-commercetools-and-talonone).

## Improve the accelerator

The accelerator is an open-source project. If you would like to add features or submit
any improvements, in the [GitHub repository][repo], see the
[contributing guidelines][guidelines].

[guidelines]: https://github.com/talon-one/commercetools-talonone-accelerator/blob/master/.github/CONTRIBUTING.md
[repo]: https://github.com/talon-one/commercetools-talonone-accelerator