Modulo LorisMenghi_ContrassegnoOrderSpoki

Versione 1.0.3 — conferma ordini in contrassegno via WhatsApp automatizzata con Spoki.

L'estensione invia automaticamente un messaggio WhatsApp tramite Spoki quando viene inserito un ordine in contrassegno. Il cliente riceve due pulsanti (Conferma / Annulla) definiti nell'automazione Spoki; l'invio avviene una sola volta per ordine e ogni chiamata è registrata in tabella spoki_contrassegno_log con possibilità di reinvio manuale dal backend Magento.

• Compatibile con Magento Open Source / Adobe Commerce 2.4.x e PHP 7.4+.
• Funziona con i metodi di pagamento COD configurati (es. msp_cashondelivery, cashondelivery).
• Richiede account Spoki con template approvato dotato di due quick-reply e automazione con trigger Webhook/API.
• Dipendenza Composer: lorismenghi/module-core installata automaticamente.

User Guide

Workflow principale:

1. All'inserimento dell'ordine Magento verifica che il modulo sia attivo e che il metodo di pagamento rientri nell'elenco COD.
2. Estrae nome, cognome, email e telefono dal checkout e invia il payload JSON all'endpoint Webhook configurato in Spoki.
3. Spoki gestisce template e automazioni (pulsanti di conferma/annullamento, messaggi successivi, esito).
4. Ogni invio viene salvato in log per evitare duplicazioni; dal backend è possibile rivedere e reinviare il payload.

Installation Guide

Installazione consigliata via Composer dalla root di Magento:

composer require lorismenghi/module-contrassegno-order-spoki
bin/magento module:enable LorisMenghi_ContrassegnoOrderSpoki
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento cache:flush
                

Dopo l'installazione apri Stores → Configuration → Loris Menghi → Spoki Cash on Delivery e imposta:

• Enable module: abilita/disabilita invio automatico (scopo per website/store view).
• Cash on delivery payment methods: codici metodi COD separati da virgola.
• Spoki API URL: URL Webhook generato in Spoki.
• Spoki Secret: secret dell'automazione/template (crittografato in Magento).

Reference Manual

• Trigger: evento ordine completato con metodo COD ammesso; invio unico per ordine.
• Payload: telefono (normalizzato con prefisso, default +39), nome, cognome, email, secret.
• Logs: menù admin Loris Menghi → Spoki Cash on Delivery Logs, con dettaglio payload, esito HTTP e azione "Resend".
• Multi-store: tutte le configurazioni sono scope-aware (Default/Website/Store View).
• Troubleshooting: controllare abilitazione modulo, correttezza codici pagamento, raggiungibilità endpoint Spoki e validità del numero di telefono.
• Disinstallazione: composer remove lorismenghi/module-contrassegno-order-spoki seguito da bin/magento setup:upgrade e bin/magento cache:flush.