La vita di un messaggio
Dopo l'invio, ogni destinatario viene messo in coda e addebitato, poi affidato a una rotta dell'operatore (inviato). In seguito l'operatore comunica se il telefono lo ha ricevuto (consegnato) oppure no (non riuscito).
Quando arrivano i rapporti
La maggior parte dei rapporti arriva in pochi secondi o in qualche minuto. Alcuni operatori li inviano in ritardo o non li inviano affatto; un messaggio senza rapporto resta nello stato inviato.
Rimborsi
Un messaggio non riuscito viene rimborsato automaticamente sul tuo saldo. Puoi vedere ogni rimborso nella cronologia del saldo, con l'id del messaggio.
Ricevere i webhook
Aggiungi un indirizzo https nella pagina della chiave API. Quando un messaggio viene consegnato o non riesce, inviamo con POST un corpo JSON con l'id del messaggio, il numero, lo stato, il prezzo e il tuo ref. Rispondi con un qualsiasi stato 2xx; altrimenti riproviamo fino a 8 volte nell'arco di circa due ore.
Verificare la firma
Ogni webhook include X-PortSMS-Signature: t=<time>,v1=<hex>. Calcola l'HMAC-SHA256 del testo t.body con il tuo segreto di firma e confrontalo con v1. Rifiuta le richieste più vecchie di cinque minuti, così una richiesta vecchia non può essere riprodotta.
