Un workflow HubSpot non può inviare codici monouso. L’azione Send WhatsApp Template di Flowella non può assegnare a un pulsante OTP o di copia codice un valore diverso per ogni contatto, e HubSpot non dovrebbe conservare i codici. Inviate invece i codici dalla vostra app con l’API.
In sintesi
Come funziona
Il diagramma mostra un tentativo di accesso, dalla richiesta del codice all’accesso o al blocco.Prima di iniziare
- Create una chiave API. Vedere Chiavi API. Questo endpoint accetta solo chiavi API, non token di accesso OAuth.
- Raccogliete il numero WhatsApp di ogni cliente in formato internazionale, come
+447700900123, e il suo consenso a ricevere codici su WhatsApp. Consultate le indicazioni sull’opt-in di Meta. - Leggete l’introduzione all’API per autenticazione, errori e limiti di frequenza.
Creare il template
Create il template nel WhatsApp Manager di Meta, con la categoria Authentication e un pulsante di copia codice. Solo i template di autenticazione possono contenere un codice monouso, e richiedono un pulsante di copia codice o one-tap. Meta stabilisce il testo: “<code> is your verification code.” Potete aggiungere un invito a non condividere il codice e una riga di scadenza da 1 a 90 minuti.
URL, media ed emoji non sono consentiti, e il codice può avere fino a 15 caratteri. Una volta che Meta approva il template, questo appare in Flowella. Consultate le linee guida di Meta sulla categorizzazione dei template e i template di autenticazione con copia codice.
Se scrivete ai clienti anche in caso di blocco, usate un template Utility separato, come Hi {{1}}, we have paused sign-in to your account after several incorrect codes. Try again in 30 minutes or contact our support team. Un avviso di sicurezza dell’account senza promozioni rientra nella categoria Utility.
Inviare un codice
1
Trovare il template e il canale
Chiamate
GET /v1/templates?status=APPROVED. Annotate l’id e il wabaId del vostro template, e il whatsappChannelId del numero da cui inviate. Vedere Multicanale se avete più numeri.2
Creare il codice nella vostra app
Generate un codice casuale di massimo 15 caratteri. Memorizzatene un hash con una scadenza breve e contrassegnatelo come monouso.
3
Inviare la richiesta
Inserite il codice due volte: una come parametro del corpo e una come valore del pulsante di copia codice. Il formato di invio di Meta tratta il pulsante di copia codice come un pulsante URL, quindi usate Una risposta
subType url, con index 0 per il primo pulsante.202 con "status": "accepted" significa che Flowella ha messo in coda l’invio. Non conferma la consegna.4
Verificare il codice
Quando il cliente digita il codice, confrontatelo con l’hash memorizzato. Accettatelo una sola volta, e solo prima della scadenza.
5
Gestire nuovi invii e blocco
Inviate un nuovo codice per ogni tentativo e invalidate quello precedente. Attendete almeno 15 secondi prima di un nuovo invio: Flowella salta un secondo invio dello stesso template allo stesso numero entro 15 secondi. Limitate i tentativi, poi bloccate l’accesso per un periodo stabilito e offrite assistenza.
6
Registrare l'esito in HubSpot (facoltativo)
Fate aggiornare alla vostra app il contatto HubSpot tramite l’API di HubSpot, ad esempio Last WhatsApp verification (Date and time picker) e Last verification result (Dropdown select: Passed, Failed, Locked). Un workflow HubSpot può quindi creare un’attività quando il risultato è Locked. Non memorizzate mai i codici in HubSpot.
Testare l’integrazione
- Inviate un codice al vostro numero WhatsApp e verificate che il pulsante di copia codice lo copi.
- Inserite un codice errato, poi richiedete un nuovo invio dopo l’attesa e verificate che il vecchio codice non funzioni più.
- Monitorate la consegna con gli eventi webhook
message.deliveredemessage.failed. Vedere Webhook.
Risoluzione dei problemi
Correlati
- Introduzione all’API: autenticazione, idempotenza, errori e limiti di frequenza.
- Riferimento dei template: categorie dei template e tipi di pulsante.
- Webhook: ricevete gli eventi di consegna da Flowella.