---
title: "Collega Mapp"
description: "Crea un utente API in Mapp Engage, collegalo e aggiungi i nuovi iscritti come contatti a un gruppo di Mapp."
url: https://scratcher.io/it/help/integrations/mapp
language: it
---

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

# Collega Mapp

Crea un utente API in Mapp Engage, collegalo e aggiungi i nuovi iscritti come contatti a un gruppo di Mapp.

Con l'integrazione Mapp, chiunque si iscriva viene creato o aggiornato come contatto in Mapp Engage e aggiunto al gruppo (lista) che scegli.

## Cosa ti serve

- Un account Mapp Engage e un utente che possa creare utenti di sistema (di solito un amministratore).
- L'indirizzo API di Mapp Engage. È l'indirizzo del tuo sistema Mapp Engage con il percorso dell'API: lo trovi nella documentazione API di Mapp per il tuo sistema, oppure chiedendolo al supporto di Mapp.

## Passaggio 1: crea un utente API in Mapp Engage

Mapp Engage usa un utente separato per l'API, con nome utente e password.

1. In Mapp Engage, vai su **Administration** > **System Users**.
2. Crea un nuovo utente di sistema e chiamalo per esempio "Scratcher".
3. Dai all'utente il ruolo API (accesso API), con i diritti indicati qui sotto.
4. Imposta una password sicura e salva. Copia il nome utente e la password.

## I diritti di cui ha bisogno l'utente API

Scratcher usa l'utente per:

- leggere i tuoi gruppi, così puoi sceglierne uno nella campagna;
- leggere gli attributi dei contatti, così puoi mappare i campi su di essi;
- creare e aggiornare contatti;
- aggiungere contatti ai gruppi (iscriverli).

L'utente non ha bisogno di accedere a messaggi, report o altro.

## Passaggio 2: collega Mapp a Scratcher

1. In Scratcher, vai su **Impostazioni** > **Integrazioni** e clicca su **Mapp**.
2. Incolla l'indirizzo API, il nome utente e la password nei campi corrispondenti.
3. Clicca su **Installa integrazione**. Scratcher controlla di poter leggere i tuoi gruppi.

## Passaggio 3: attivalo in una campagna

1. Nell'editor, vai su **Collega** > **Integrazioni** > **Mapp** e clicca su **Attiva**.
2. Se hai collegato più di un account, sceglilo in **Seleziona account**.
3. In **Lista esterna**, scegli il gruppo di Mapp.
4. In **Mappature dei campi**, clicca su **Aggiungi mappatura dei campi** e abbina ogni **Campo Scratcher** a un attributo di Mapp, per esempio "Lead - Nome" a **FirstName**.
5. In **Filtra per consensi (facoltativo)**, scegli la tua casella di consenso al marketing.
6. Clicca su **Salva** e poi su **Test**.

## Mappatura dei campi

- L'indirizzo email viene sempre inviato e identifica il contatto. Non devi mapparlo.
- L'elenco **Campo di destinazione** mostra gli attributi standard e personalizzati del tuo sistema Mapp. Crea prima gli attributi personalizzati in Mapp.
- Per i numeri di cellulare, usa l'impostazione **Formato**. Di solito Mapp si aspetta + e prefisso internazionale.

## Consenso

I contatti vengono iscritti al gruppo che scegli. Se il gruppo usa il double opt-in in Mapp, Mapp invia la propria email di conferma e le persone vengono iscritte solo quando confermano. Usa **Filtra per consensi** così vengono aggiunte solo le persone che hanno spuntato la tua casella per il marketing.

## Cosa viene inviato e quando

I nuovi iscritti vengono inviati entro un paio di minuti. Quando attivi l'integrazione, vengono inviati anche i lead già presenti nella campagna. Quando qualcuno partecipa di nuovo, il contatto viene aggiornato. Controlla ogni consegna in **Impostazioni** > **Integrazioni** > **Stato della consegna**.

## Risoluzione dei problemi

- "All or some of the fields are invalid..." durante l'installazione: controlla l'indirizzo API e che l'utente di sistema abbia il ruolo API e non sia bloccato.
- Le consegne non riescono con un errore di accesso: all'utente di sistema manca uno dei diritti indicati sopra.
- La password è scaduta: alcuni sistemi Mapp fanno scadere le password. Imposta una nuova password in Mapp e collegati di nuovo 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.
