Documentation menu

Zapier

Collega MailInApp alle migliaia di app di Zapier: metti i nuovi lead in un foglio di calcolo, pubblica in Slack gli incontri prenotati, apri un record nel CRM quando una trattativa è vinta, oppure aggiungi un contatto a MailInApp quando succede qualcosa altrove.

L'app MailInApp per Zapier

L'app ufficiale MailInApp per Zapier è in fase di revisione da parte di Zapier e non compare ancora nella sua directory di app. Quando sarà disponibile, la collegherai con una chiave API e sceglierai attivatori e azioni dai menu, senza URL da copiare:

  • Attivatori: uno per ogni evento dell'account, tra cui New Lead, Lead Turned Hot, Meeting Booked, Deal Stage Changed, Form Submitted, Purchase Completed e Journey Completed.
  • Azioni: Create or Update Contact, Trigger Journey, Create Deal, Update or Move Deal e Send Transactional Email.
  • Ricerca: Find Contact, che si abbina alla creazione come «Find or Create Contact».

Questa pagina rimanderà alla scheda dell'app appena sarà pubblicata. Nel frattempo, tutto ciò che segue funziona già oggi con l'app integrata Webhooks by Zapier.

Inviare gli eventi di MailInApp a uno Zap

  1. In Zapier, crea uno Zap con Webhooks by Zapier come attivatore e Catch Hook come evento. Copia l'URL che Zapier ti fornisce.
  2. In MailInApp, vai in Sviluppatori → Webhook. Incolla l'URL come URL dell'endpoint, spunta gli eventi che questo Zap deve ricevere e fai clic su Aggiungi webhook. Conserva il segreto di firma se pensi di verificare le firme più avanti.
  3. Fai clic su Invia prova sul nuovo webhook, poi su Test trigger in Zapier. Vedrai l'evento di esempio, con il suo type e ogni campo di data, come l'email del contatto o la fase della trattativa.
  4. Aggiungi i passaggi di azione, mappa i campi che ti servono e attiva lo Zap.

Ogni evento ha la stessa forma: un id, un type, una data createdAt e un oggetto data. La pagina dei webhook elenca ogni evento e i suoi campi. Se uno stesso Catch Hook riceve più tipi di eventi, aggiungi un passaggio Filter by Zapier su type, oppure crea un webhook per Zap.

Ti servono solo le interazioni di una singola email, come ogni risposta a un sondaggio specifico? Incolla invece l'URL del Catch Hook nel webhook di progetto di quell'email, nella sua pagina Risposte.

Agire su MailInApp da uno Zap

Usa un'azione Webhooks by Zapier → Custom Request per chiamare l'API di MailInApp con la tua chiave API in un'intestazione Authorization: Bearer mia_live_…. Per esempio:

  • Aggiungere o aggiornare un contatto quando qualcuno compila un modulo altrove: POST /api/v1/contacts.
  • Aprire una trattativa quando un lead prenota una chiamata in un altro strumento: POST /api/v1/deals. Imposta un'intestazione Idempotency-Key, come l'identificativo del record nell'altro strumento, così un nuovo tentativo dello Zap non crea una seconda trattativa.
  • Iscrivere un contatto a un journey il cui attivatore è Chiamata API: POST /api/v1/journeys/{id}/trigger.
  • Inviare una ricevuta o una notifica: POST /api/v1/send con "type": "transactional". Non inviare email di marketing da uno Zap: uno Zap non può dimostrare che il destinatario ha dato il consenso.

Quando una consegna non riesce

Uno Zap in pausa o eliminato, o un'interruzione di Zapier, conta come consegna non riuscita. MailInApp la ritenta automaticamente per diverse ore. L'evento viene sempre salvato prima in MailInApp, quindi lato MailInApp non si perde nulla.