Webhook Prestashop: setup integrazioni

I webhook Prestashop permettono al negozio di notificare sistemi esterni quando accadono eventi (nuovo ordine, cambio stato, modifica prodotto). Prestashop non ha webhook outbound nativi: si implementano via hook + modulo custom che fa POST HTTP. Vediamo l'architettura tipica.

Hook nativi disponibili

Prestashop offre decine di hook lato actionXxx: actionValidateOrder (nuovo ordine), actionOrderStatusUpdate (cambio stato), actionProductSave, actionCustomerAccountAdd. Ogni hook riceve parametri dell'evento. Un modulo custom può registrare l'hook e inviare i dati a un'endpoint esterno via cURL o file_get_contents.

Strutture e sicurezza

Aggiungi signature HMAC al payload per garantire integrità: il ricevente verifica firma con secret condiviso. Implementa retry con backoff in caso di errore HTTP del ricevente. Logga ogni invio in tabella custom per debugging. Per integrazioni Zapier/Make conviene usare i loro endpoint catch-hook e mappare le risorse.

Procedura passo-passo

1. Crea modulo custom nomemodulo_webhook.
2. In install() registra gli hook necessari (actionValidateOrder, etc.).
3. Implementa metodo handler hookActionValidateOrder($params).
4. Recupera oggetto Order e serializza i dati in JSON.
5. Calcola HMAC SHA256 con secret condiviso.
6. Invia POST HTTP a endpoint esterno con header Authorization signature.
7. Gestisci risposta: se non 2xx, logga e schedula retry.
8. Crea pagina configurazione per impostare endpoint e secret.
9. Test con Zapier o Make come ricevente.
10. Pianifica cron per retry dei webhook falliti.

Errori comuni e come risolverli

• Webhook bloccato: PHP esegue cURL sincrono; usa shell_exec in background o queue.
• Signature mismatch: encoding payload diverso; allinea con ricevente.
• Timeout: ricevente lento; setta cURL timeout basso, schedula retry.
• Duplicati: hook scatena più' volte; deduplica con idempotency key.

Domande frequenti

D: Webhook inbound?
R: Sì, via controller front custom che riceve POST da terzi.

D: Quanti webhook posso configurare?
R: Nessun limite tecnico; valuta latenza totale dell'ordine.

D: Esistono moduli pronti?
R: Sì, su Addons cerca webhooks o Zapier.

Hai bisogno di aiuto?

Se vuoi un Prestashop performante curato dal team di G Tech Group, scrivici tramite il modulo di contatto.