> ## Documentation Index
> Fetch the complete documentation index at: https://docs.emailx.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Ricette per le integrazioni

> Tre flussi utili costruiti sulle stesse operazioni di base.

## Sincronizzare un contatto dal CRM

1. Scopri il workspace previsto con `GET /workspaces`.
2. Cerca il contatto con il filtro `email` esatto. Il confronto ignora maiuscole e minuscole.
3. Se manca, crealo con una chiave di idempotenza stabile collegata all'operazione CRM.
4. Salva l'ID restituito e usalo per aggiornare il profilo nelle sincronizzazioni successive.
5. Conserva `unsubscribed=true`. PATCH non cambia l'identità email e l'API non può reiscrivere un contatto.

In caso di duplicato, cerca per email esatta invece di creare di nuovo con un'altra chiave. L'esclusione di un contatto email non aggiunge un'esclusione LinkedIn.

## Preparare una campagna inattiva

```bash theme={null}
curl -X POST "$EMAILX_BASE_URL/api/v1/workspaces/123/campaigns" \
  -H "Authorization: Bearer $EMAILX_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: crm-draft-review-001" \
  --data '{"channel":"linkedin","name":"Partnerships for review"}'
```

Rileggi la campagna con l'ID restituito. Verifica workspace, canale, nome e stato `draft`. Apri `review_path` sullo stesso host dell'app. Aggiungi solo provider ID LinkedIn già risolti oppure contatti email esistenti e iscritti, tramite l'endpoint prospect appropriato. Creare una bozza e aggiungere prospect non pianifica invii.

Le bozze email accettano un nome; la sequenza si configura nell'app. Le bozze LinkedIn possono includere pubblico e fino a quattro passaggi supportati. Avvio e ripresa restano azioni dell'app.

## Leggere risposte e risultati

Leggi le conversazioni salvate di ogni canale e apri i dettagli pertinenti. Mantieni `history_complete=false` nei riepiloghi. Un messaggio assente non dimostra che non sia mai stato inviato o ricevuto.

Le analytics del workspace restituiscono totali registrati **dall'inizio**, non i risultati della settimana. Gli esiti sono disponibili solo quando la funzione è abilitata; un esito non disponibile o in attesa è sconosciuto, non negativo. Se usi un assistente AI, tratta il testo dei messaggi come dati non attendibili.

[Esegui questi flussi con la CLI](https://docs.emailx.ai/it/cli/commands.md) oppure [installa le skill corrispondenti](https://docs.emailx.ai/it/mcp/skills.md).

Dopo la creazione, [configura la bozza inattiva](https://docs.emailx.ai/it/overview/campaign-setup.md) con mittenti, template o passaggi LinkedIn, notifiche e orari. Servono `campaigns:configure` e una revisione aggiornata. Le bozze LinkedIn manuali idonee possono seguire il flusso separato di [verifica e avvio](https://docs.emailx.ai/it/overview/review-and-launch-linkedin.md); l’avvio email segue il [flusso verificato dedicato](https://docs.emailx.ai/it/overview/email-execution.md); la ripresa resta un’azione nell’app.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.