---
title: "Collega Ortto"
description: "Crea una chiave Custom API in Ortto, collegala e crea o aggiorna le persone con i campi che scegli."
url: https://scratcher.io/it/help/integrations/ortto
language: it
---

1. [Centro assistenza](https://scratcher.io/it/help)
2. [Integrazioni](https://scratcher.io/it/help/integrations)
3. Collega Ortto

# Collega Ortto

Crea una chiave Custom API in Ortto, collegala e crea o aggiorna le persone con i campi che scegli.

Con l'integrazione Ortto, chiunque si iscriva viene creato o aggiornato come persona in Ortto, abbinato in base al suo indirizzo email.

## Cosa ti serve

- Un account Ortto e un utente che possa aggiungere data source.
- Il tuo account Ortto deve essere ospitato nella regione europea di Ortto, perché Scratcher si collega all'API europea di Ortto. Se il tuo account si trova in un'altra regione, scrivici in chat.

## Passaggio 1: crea una chiave API in Ortto

1. In Ortto, vai su **Data sources** e clicca su **New data source**.
2. Scegli **Custom API**.
3. Dalle un nome che riconosci, per esempio "Scratcher".
4. Copia l'**API key** che mostra Ortto e completa la creazione della data source.

## I permessi di cui ha bisogno la chiave

Scratcher usa la chiave per leggere le persone, crearle o aggiornarle (merge) e leggere i tuoi campi personalizzati delle persone. Se Ortto ti chiede quali azioni può eseguire la chiave, consenti queste. Non serve altro.

## Passaggio 2: collega Ortto a Scratcher

1. In Scratcher, vai su **Impostazioni** > **Integrazioni** e clicca su **Ortto**.
2. Incolla la chiave in **Api Key**.
3. Clicca su **Installa integrazione**. Scratcher controlla di poter leggere le persone in Ortto.

## Passaggio 3: attivalo in una campagna

1. Nell'editor, vai su **Collega** > **Integrazioni** > **Ortto** e clicca su **Attiva**.
2. Se hai collegato più di un account, sceglilo in **Seleziona account**.
3. In **Mappature dei campi**, abbina ogni **Campo Scratcher** a un campo di Ortto. Non c'è una lista da scegliere: Ortto riceve tutti in un unico posto, e li raggruppi con le audience di Ortto.
4. In **Filtra per consensi (facoltativo)**, scegli la tua casella di consenso al marketing.
5. Clicca su **Salva** e poi su **Test**.

> Buono a sapersi: in Ortto non c'è una lista da scegliere, quindi Scratcher inizia a inviare appena clicchi su **Attiva**. Attivalo prima che la campagna vada online, oppure configuralo subito.

## Mappatura dei campi

- Email e numero di telefono vengono inviati automaticamente.
- Oltre ai tuoi campi personalizzati, puoi mappare su **Name**, **First name**, **Last name**, **Birthday**, **City**, **Country**, **Region**, **Postal code**, **Language**, **GDPR** ed **External ID**.
- Mappa il campo **Accettato** di un consenso su **GDPR** per registrare il consenso in Ortto.

## Cosa viene inviato e quando

I nuovi iscritti vengono inviati entro un paio di minuti, e i lead già presenti vengono inviati quando attivi l'integrazione. **Stato della consegna** mostra se ogni persona è stata creata o esisteva già.

## Risoluzione dei problemi

- "All or some of the fields are invalid..." durante l'installazione: la chiave è sbagliata, oppure il tuo account Ortto non si trova nella regione europea.
- Le consegne non riescono: la data source è stata eliminata oppure la chiave è stata cambiata in Ortto. Crea una nuova chiave e collegala con **Aggiungi nuovo account**.

Integrazioni

- [Come funzionano le integrazioni](https://scratcher.io/it/help/integrations/how-integrations-work)
- [Tutte le integrazioni](https://scratcher.io/it/help/integrations/other-integrations)
- [Controlla lo stato della consegna e invia di nuovo i lead](https://scratcher.io/it/help/integrations/delivery-status)
- [Collega HubSpot](https://scratcher.io/it/help/integrations/hubspot)
- [Collega Salesforce Marketing Cloud](https://scratcher.io/it/help/integrations/salesforce-marketing-cloud)
- [Collega Microsoft Dynamics 365 con Zapier](https://scratcher.io/it/help/integrations/microsoft-dynamics-365)
- [Collega Emarsys](https://scratcher.io/it/help/integrations/emarsys)
- [Collega Klaviyo](https://scratcher.io/it/help/integrations/klaviyo)
- [Collega Mailchimp](https://scratcher.io/it/help/integrations/mailchimp)
- [Collega ActiveCampaign](https://scratcher.io/it/help/integrations/activecampaign)
- [Collega Apsis One](https://scratcher.io/it/help/integrations/apsis-one)
- [Collega Drip](https://scratcher.io/it/help/integrations/drip)
- [Collega HeyLoyalty](https://scratcher.io/it/help/integrations/heyloyalty)
- [Collega Peytz](https://scratcher.io/it/help/integrations/peytz)
- [Collega Marketingplatform](https://scratcher.io/it/help/integrations/marketingplatform)
- [Collega Campaign Monitor con Zapier](https://scratcher.io/it/help/integrations/campaign-monitor)
- [Collega ActiveTrail con Zapier](https://scratcher.io/it/help/integrations/activetrail)
- [Collega Bloomreach](https://scratcher.io/it/help/integrations/bloomreach)
- [Collega Iterable](https://scratcher.io/it/help/integrations/iterable)
- [Collega Mapp](https://scratcher.io/it/help/integrations/mapp)
- [Collega Agillic](https://scratcher.io/it/help/integrations/agillic)
- [Collega Ortto](https://scratcher.io/it/help/integrations/ortto)
- [Collega Emarketeer](https://scratcher.io/it/help/integrations/emarketeer)
- [Collega Shopify](https://scratcher.io/it/help/integrations/shopify)
- [Collega Hello Retail](https://scratcher.io/it/help/integrations/hello-retail)
- [Collega oltre 8.000 app con Zapier](https://scratcher.io/it/help/integrations/zapier)
- [Collega monday.com con Zapier](https://scratcher.io/it/help/integrations/monday-com)
- [Collega Asana con Zapier](https://scratcher.io/it/help/integrations/asana)
- [Collega Podio con Zapier](https://scratcher.io/it/help/integrations/podio)
- [Collega Intercom con Zapier](https://scratcher.io/it/help/integrations/intercom)

Continua a imparare

## Articoli correlati

- [Come funzionano le integrazioni](https://scratcher.io/it/help/integrations/how-integrations-work): Collega una volta il tuo strumento di email marketing o il CRM, attivalo in ogni campagna, scegli una lista, abbina i campi e invia solo chi ha dato il consenso.
- [Controlla lo stato della consegna e invia di nuovo i lead](https://scratcher.io/it/help/integrations/delivery-status): Scopri quali lead sono stati inviati ai tuoi strumenti, capisci i messaggi di errore, risolvi il problema e inviali di nuovo.
- [Chiedi il consenso e aggiungi termini e condizioni](https://scratcher.io/it/help/forms/consent-and-permissions): Aggiungi caselle di consenso per le newsletter, collega il tuo regolamento, scegli quale casella iscrive le persone e invia al tuo strumento di email marketing solo chi ha detto sì.

Ti serve una mano?

## Hai ancora bisogno di aiuto?

Persone vere sono qui per aiutarti. Se usi già Scratcher, il modo più veloce è la chat all'interno della piattaforma.

- **[Chatta con noi](https://platform.scratcher.io/it/login)**

    Accedi e clicca sul pulsante della chat in basso a destra. Rex risponde subito e il nostro team è a un clic di distanza.
- **[Prenota un incontro](https://scratcher.io/it/book-a-meeting)**

    Una videochiamata gratuita di 30 minuti con il nostro team: un tour, idee per campagne o aiuto con la configurazione.
- **[Scrivici](mailto:contact@scratcher.io)**

    Scrivi a contact@scratcher.io e ti risponderemo.
