Collega WhatsApp a Zoho CRM su un numero Coexistence

Come diventa un record Zoho CRM un messaggio WhatsApp?

Meta invia ogni messaggio del numero alla destinazione webhook che hai impostato, qui un nodo Webhook di n8n. Il workflow prende il numero del mittente dal payload e chiama l'endpoint di ricerca di Zoho con phone impostato su quel valore, prima su Leads e poi su Contacts. Zoho controlla tutti i campi telefono del modulo, quindi una corrispondenza su Mobile o su Phone vale in entrambi i casi, e non devi indovinare quale campo abbia usato un commerciale.

Se non torna nulla, il nodo Zoho CRM di n8n crea un Lead con il nome del profilo WhatsApp e il numero. In ogni caso il workflow ha ora un id del record e scrive il messaggio come nota su quel record tramite POST /Notes. Una nota richiede solo Note_Content e un Parent_Id che indica il modulo e il record.

{
  "data": [
    {
      "Note_Title": "WhatsApp, inbound",
      "Note_Content": "do you have anything friday?",
      "Parent_Id": {
        "module": { "api_name": "Leads" },
        "id": "4876876000000624001"
      }
    }
  ]
}

Di quali permessi Zoho ha bisogno la credenziale n8n?

Lettura e creazione sui moduli in cui cerchi e scrivi, più la creazione su Notes. Zoho chiama lo scope della nota ZohoCRM.modules.notes.CREATE e richiede accanto lo scope di creazione del modulo padre, quindi una credenziale che può creare Lead ma non ha mai ricevuto lo scope delle note fallisce all'ultimo passaggio con un errore di autorizzazione.

Il nodo Zoho CRM di n8n copre Leads, Contacts, Accounts, Deals e diversi documenti di vendita, con create, upsert, get, get all, update e delete. Le note non sono tra le sue risorse, per questo la nota passa da un nodo HTTP Request. n8n permette a quel nodo di riutilizzare la credenziale Zoho che hai già collegato, quindi gestisci una sola autorizzazione OAuth invece di due.

Imposta il dominio API sul tuo data center Zoho. Una credenziale creata nella regione EU chiama zohoapis.eu, non zohoapis.com.

Quanti messaggi può assorbire Zoho CRM?

Zoho misura la sua API in crediti su 24 ore mobili, e il budget dipende da edizione e numero di utenti. L'edizione Free ne ha 5.000. Standard ha 50.000 più 250 per utente, Professional 50.000 più 500 per utente ed Enterprise 50.000 più 1.000 per utente, ciascuna con un tetto per edizione.

Ogni messaggio in arrivo costa una ricerca e la scrittura di una nota, più la creazione di un lead per chi scrive la prima volta. È un consumo ampiamente dentro il budget di un'edizione a pagamento per il numero di una piccola azienda. Il limite che si fa sentire per primo è di solito la concorrenza: Free consente 5 chiamate simultanee e Standard 10, quindi un'ondata di risposte a un broadcast può finire in coda. Se Zoho restituisce errori di limite, imposta il workflow n8n in modo che elabori le esecuzioni una alla volta.

Le risposte inviate dal telefono arrivano su Zoho CRM?

Possono arrivare. Su un numero Coexistence l'app WhatsApp Business continua a funzionare, e quando qualcuno risponde da lì Meta invia un'eco di quel messaggio in uscita alla stessa destinazione webhook, nel campo smb_message_echoes.

Dai al workflow un ramo per le eco e scrivile come note con titolo da messaggio in uscita. Il commerciale che apre il lead in Zoho legge così entrambi i lati della conversazione, e nessuno deve incollare screenshot nel CRM.

I messaggi che il workflow invia da solo tramite la Cloud API, come un template approvato dopo il cambio di fase di una trattativa, conviene registrarli al momento dell'invio, perché il workflow ha già il testo e l'id del record.

Errori comuni

• Dare alla credenziale gli scope dei lead ma non ZohoCRM.modules.notes.CREATE. La ricerca e il lead funzionano, poi ogni nota fallisce.
• Chiamare zohoapis.com da un account che sta in un altro data center Zoho. Usa il dominio API della regione in cui vive l'account.
• Cercare solo tra i Leads. I clienti convertiti sono Contacts, e ognuno che scrive diventa un nuovo lead duplicato.

Domande frequenti

Continua a leggere