Webhooks
Ricevi chiamate in tempo reale sugli aggiornamenti in Smstools.
Cosa sono i webhooks?
I webhooks sono un'estensione di un'API, ma invece che il tuo codice richieda dati da Smstools, Smstools invia dati a te. I dati arrivano in una richiesta web alla tua applicazione. I webhooks sono anche utilizzati per notificare la tua applicazione di eventi come una chiamata in arrivo o un messaggio. Poiché i server di Smstools devono essere in grado di inviare dati alla tua applicazione tramite webhooks, è necessario configurare un server web per ricevere le richieste HTTP in arrivo. È anche necessario specificare l'URL di ogni webhook sul tuo server web in modo che i dati possano essere inviati a ciascuno.
Panoramica dei webhooks disponibili
| Tipo | Descrizione |
|---|---|
| delivery_report | Rapporto di consegna dopo ogni messaggio inviato. A volte possono esserci 2 webhooks: prima uno stato 'inviato' e successivamente uno stato 'consegnato' o 'non consegnato'. A volte sono disponibili dettagli aggiuntivi quando il messaggio non viene consegnato. |
| read_report | Conferma di lettura dopo che il messaggio è stato letto. Una conferma di lettura è disponibile solo per la Messaggistica Sociale o utilizzando il link 'Richiedi un rapporto di lettura'. |
| inbox_message | Messaggio in arrivo. Disponibile solo se si utilizza la Messaggistica Sociale o un numero virtuale. |
Codici di rapporto di consegna
| Codici di dettaglio del rapporto di consegna | Stato | Spiegazione |
|---|---|---|
| 0 | SUBMITTED | Questo messaggio è stato consegnato con l'operatore ma non abbiamo ricevuto alcun rapporto di consegna. |
| 1 | DELIVERED | Questo messaggio è stato consegnato correttamente. |
| 2 | NOT DELIVERED | Questo messaggio non è stato consegnato. Possibile motivo: il destinatario è fuori dal raggio di rete, problemi di rete, destinatario in paese straniero. |
| 3 | BUFFERED | Questo messaggio è stato consegnato con l'operatore ma non consegnato al destinatario. |
| 4 | REJECTED | Questo messaggio è stato rifiutato dall'operatore. |
| 5 | REJECTED | Informazioni estese di seguito! |
| 9 | UNKNOWN | Non ci sono rapporti di consegna disponibili per questo messaggio. |
Codici di dettaglio del rapporto di consegna
| Stato | Spiegazione |
|---|---|
| 10 | Il numero del destinatario non è valido o sconosciuto |
| 11 | Il destinatario è temporaneamente fuori dal raggio dell'operatore di rete |
| 12 | Problema legato al telefono. |
| 13 | Problema di rete dell'operatore |
| 14 | Messaggio scaduto - motivo sconosciuto |
| 15 | Il destinatario è elencato in una lista nera |
| 16 | Problema di contenuto del messaggio |
| 17 | Il destinatario non può essere liquidato |
| 18 | L'operatore ha rifiutato questo a causa di spam |
| 19 | Il sottoscrittore non può ricevere messaggi premium (bloccato dall'operatore) |
Codici di dettaglio del rapporto di consegna sul codice di risposta 5
| Stato | Spiegazione |
|---|---|
| 2000 | INSUFFICIENT_FUNDS |
| 2001 | TOO_LONG |
| 2002 | TOO_SHORT |
| 2003 | TIMEOUT |
| 2004 | GATEWAY_ISSUES |
| 2005 | INVALID_SENDER |
| 2006 | INVALID_NUMBER |
| 4000 | UNKNOWN |
| 4001 | EMPTY_MESSAGE |
| 4002 | EMPTY_CLIENT |
| 4003 | LOCKED |
| 4004 | BLOCKED |
| 4005 | JOB_FAILED |
| 4006 | DUPLICATE |
| 4007 | INVALID_CONTENT |
Esempio: rapporto di consegna
[
{
"webhook_id": "svt1jtrmekgb67ratwa31ptupc",
"webhook_type": "delivery_report",
"username": "myusername",
"message": {
"messageid": "e1qk89exbzgf6fzfunceym2sd67h88",
"datetime": "2019-01-01 00:00:00",
"content": "here comes your message body",
"sender": "yoursender",
"receiver": "32470123456",
"reference": "yourref",
"delivery_code": "1", [Possible values: 0,1,2,3,4,9]
"delivery_status": "delivered" [code explanation]
"delivery_code_detail": "10", [delivery code with additional details]
"delivery_code_detail_description": "Unknown Subscriber" [detailed explanation]
}
}
]
Esempio: messaggio in arrivo
[
{
"webhook_id": "xvt1jtrrekgb67ratwa31ptuzp",
"webhook_type": "inbox_message",
"username": "myusername",
"message": {
"id": "12345678",
"date": "2019-01-01 00:00:00",
"sender": "sendernumber",
"receiver": "12345678",
"content": "message content",
"type": "sms" [Possible values: sms,whatsapp]
}
"isreply": { [The isreply content will only be added when the message was replied to another message]
"reply": true,
"orig_message_content": "original message content",
"orig_messageid": "985zvqipp73csuuha2079fbshx",
"orig_messagedate": "2019-01-01 00:00:00",
"orig_sender": "32471123456",
"orig_receiver": "12345678",
"orig_reference": ""
}
}
]
Esempio: rapporto di conferma di lettura
[
{
"webhook_id": "xvt1jtrrekgb67ratwa31ptuzp",
"webhook_type": "read_report",
"username": "myusername",
"message": {
"messageid": "e1qk89exbzgf6fzfunceym2sd67h88",
"datetime": "2019-01-01 00:00:00",
"content": "here comes your message body",
"sender": "yoursender",
"receiver": "32470123456",
"reference": "yourref",
"delivery_code": "1",
"delivery_status": "delivered"
"read_status": "message_read",
"read_datetime": "2019-01-01 00:01:00"
}
}
]
Webhooks
5 su 5 basato su 2647 valutazioni degli utenti.