Mandare lead a Skeo da Make o dal tuo server

I contatti passano da uno scenario di Make, o li manda il server del tuo sito, o il tuo sviluppatore vuole collegarli lui? Basta una chiave segreta: ogni richiesta con un nome, un'email o un telefono diventa un lead nel kanban. Usi Zapier? C'è la guida per Zapier. Hai un assistente AI che lavora sul sito? Vedi la guida per l'assistente AI.

In Skeo: crea la chiave

1. Apri Connettori, riquadro Il modulo del tuo sito, e scegli Da un programma.
2. Dagli un nome (per esempio "Make") e premi Crea la chiave.
3. Copia la chiave o premi Scarica le istruzioni per chi fa il sito: si vede una volta sola.

In Make: il modulo HTTP

1. Nello scenario, dopo il modulo da cui arrivano i contatti, aggiungi il modulo HTTP, azione Make a request.
2. URL: https://skeo.it/api/public/leads/inbound. Metodo: POST.
3. In Headers aggiungi una riga: nome Authorization, valore Bearer, uno spazio e la chiave.
4. Come corpo scegli application/x-www-form-urlencoded e aggiungi una riga per campo: nome, cognome, email, telefono, messaggio, scegliendo per ognuno il dato giusto dal modulo precedente. Va bene anche JSON, ma un messaggio con virgolette o a capo lo rompe.
5. Premi Run once: se la risposta è {"ok":true}, il lead è già nella prima colonna del kanban. Cancellalo pure (nel conteggio del mese resta).

Per chi sviluppa

curl -X POST "https://skeo.it/api/public/leads/inbound" \
  -H "Authorization: Bearer LA_TUA_CHIAVE_SEGRETA" \
  -H "Content-Type: application/json" \
  -d '{"nome":"Mario","cognome":"Rossi","email":"mario@esempio.it","messaggio":"Vorrei un preventivo"}'

• La chiave va solo nell'intestazione Authorization: Bearer (o X-Skeo-Key). Nell'indirizzo (?key=) viene rifiutata.
• Solo da un server: una richiesta con l'intestazione Origin di un browser viene rifiutata. Tieni la chiave tra le variabili segrete, mai nel repository.
• Aspetta la risposta prima di chiudere la richiesta: su un hosting serverless una chiamata lasciata a metà viene interrotta e il lead si perde.

Campi e risposte

CAMPI ACCETTATI
- Nome e cognome: nome_e_cognome, oppure nome + cognome (anche name, first_name, last_name)
- Email: email
- Telefono: telefono (anche phone, cellulare)
- Azienda: azienda (anche company)
- Messaggio: messaggio (anche message), finisce nelle note del lead
- Campagna: campagna, utm_source, utm_medium, utm_campaign, utm_term, utm_content
Serve almeno un nome, un'email o un telefono.
Ogni altro campo (es. settore_attivita, budget) arriva nella scheda del lead come campo
personalizzato, con il suo nome. I campi che iniziano con _ restano fuori. Massimo 20.

RISPOSTE
- 200 {"ok":true}: lead arrivato nel kanban, nella prima colonna.
- 400: mancano nome, email e telefono, o il formato non è JSON né un modulo.
- 401: chiave sbagliata, revocata o mandata nel modo sbagliato (vedi sopra).
- 429: troppi invii in poco tempo. Riprova dopo un minuto.
- 500: problema nostro. Riprova tra poco.

Chiave finita dove non doveva?

In Skeo premi Revoca su quel collegamento e creane uno nuovo: la chiave vecchia smette subito di funzionare. Tutte le altre strade per i lead dal sito sono nella guida del modulo del sito.