Slack

Introduzione

L’integrazione Slack pubblica gli eventi di Dodo Payments, come pagamenti riusciti, modifiche agli abbonamenti e contestazioni, in un canale Slack a tua scelta. Il tuo team può seguire i pagamenti e gestire le contestazioni da Slack, senza controllare la dashboard.

Il connettore Slack trasforma ogni evento di Dodo Payments in un messaggio Slack tramite una trasformazione: codice JavaScript che viene eseguito sull’evento prima della consegna. Il connettore include il codice di trasformazione, quindi non è necessaria alcuna programmazione per iniziare. Devi avere accesso a Sviluppatore → Webhook nella dashboard di Dodo Payments e l’autorizzazione ad aggiungere app al tuo workspace Slack.

Iniziare

Open the Webhook Section

Nella dashboard di Dodo Payments, vai su Developer → Webhooks e fai clic su Add endpoint.

Finestra di dialogo Add endpoint con il menu a discesa Integration impostato su Custom webhook

Select Slack Integration

In Integration, seleziona Slack. La dashboard carica il codice di trasformazione Slack e mostra i passaggi di configurazione nel pannello How to connect Slack.

Finestra di dialogo Add endpoint con Slack selezionato e i passaggi How to connect Slack

Create a Slack Webhook URL

In Slack, crea un’app con un webhook in ingresso per il canale che deve ricevere le notifiche:

Apri api.slack.com/apps, fai clic su Crea nuova app e scegli Da zero.
Assegna un nome all’app, ad esempio Dodo Payments Notifications, seleziona il tuo workspace e fai clic su Crea app.
Nella barra laterale, apri Webhook in ingresso e attiva Attiva webhook in ingresso.
Fai clic su Aggiungi nuovo webhook al workspace, scegli il canale e fai clic su Consenti.
Copia l’URL del webhook, che inizia con https://hooks.slack.com/services/.

Schermata delle autorizzazioni Slack con un selettore di canale e un pulsante Consenti

Paste the Webhook URL

Incolla l’URL del webhook Slack in URL endpoint. Slack non richiede una API key.

Select Events

Eventi sottoscritti elenca gli eventi supportati dal connettore Slack. Se modifichi la trasformazione, mantieni solo gli eventi che gestisce. Slack rifiuta una richiesta che non sia un messaggio Slack, quindi un evento che la trasformazione lascia invariato non viene consegnato.

Customize Transformation Code

In Codice di trasformazione, modifica l’handler per scegliere quali eventi pubblicano un messaggio e l’aspetto di ogni messaggio. Mantieni il codice del connettore oppure parti dagli esempi.

Editor del codice di trasformazione con l'handler Slack per gli eventi di pagamento

Test and Create

In Test this code, seleziona un tipo di evento e fai clic su Simulate. In Result viene mostrato il messaggio che Slack riceverebbe. Quindi fai clic su Create endpoint.

Pannello Test this code con payment.succeeded selezionato, un pulsante Simulate e il pulsante Create endpoint

Integration Complete!

Dodo Payments ora pubblica ogni evento sottoscritto nel tuo canale Slack. Per pubblicare un messaggio di test, apri la scheda Test dell’endpoint, seleziona un tipo di evento e fai clic su Invia esempio.

Esempi di codice di trasformazione

Ogni handler sostituisce webhook.payload con un messaggio Slack e mantiene webhook.url, il tuo URL del webhook in ingresso. Gli importi di Dodo Payments sono espressi nell’unità monetaria più piccola, quindi gli esempi li dividono per 100 e mostrano il codice della valuta. Per le valute senza decimali, come JPY e KRW, usa l’importo così com’è.

Notifiche di pagamento di base

Pubblica un messaggio in testo normale quando un pagamento va a buon fine, non va a buon fine o è in fase di elaborazione:

payment_notifs.js

function handler(webhook) {
  switch (webhook.eventType) {
    case "payment.succeeded":
      webhook.payload = {
        text: `✅ Payment Successful\nAmount: ${(webhook.payload.data.total_amount / 100).toFixed(2)} ${webhook.payload.data.currency}\nCustomer: ${webhook.payload.data.customer.email}\nPayment ID: ${webhook.payload.data.payment_id}`
      };
      break;
      
    case "payment.failed":
      webhook.payload = {
        text: `❌ Payment Failed\nAmount: ${(webhook.payload.data.total_amount / 100).toFixed(2)} ${webhook.payload.data.currency}\nCustomer: ${webhook.payload.data.customer.email}\nReason: ${webhook.payload.data.error_message || 'Unknown'}`
      };
      break;
      
    case "payment.processing":
      webhook.payload = {
        text: `⏳ Payment Processing\nAmount: ${(webhook.payload.data.total_amount / 100).toFixed(2)} ${webhook.payload.data.currency}\nCustomer: ${webhook.payload.data.customer.email}`
      };
      break;
  }

  return webhook;
}

Notifiche dettagliate degli abbonamenti

Pubblica un messaggio con codice colore e campi allegati quando un abbonamento diventa attivo, viene annullato o si rinnova:

subscription_notifs.js

function handler(webhook) {
  switch (webhook.eventType) {
    case "subscription.active":
      webhook.payload = {
        attachments: [{
          color: "good",
          title: "🎉 Subscription Activated",
          fields: [
            {
              title: "Customer",
              value: webhook.payload.data.customer.email,
              short: true
            },
            {
              title: "Product ID",
              value: webhook.payload.data.product_id,
              short: true
            },
            {
              title: "Amount",
              value: `${(webhook.payload.data.recurring_pre_tax_amount / 100).toFixed(2)} ${webhook.payload.data.currency}/${webhook.payload.data.payment_frequency_interval}`,
              short: true
            },
            {
              title: "Next Billing",
              value: new Date(webhook.payload.data.next_billing_date).toLocaleDateString(),
              short: true
            }
          ],
          footer: "Dodo Payments",
          ts: Math.floor(new Date(webhook.payload.timestamp).getTime() / 1000)
        }]
      };
      break;
      
    case "subscription.cancelled":
      webhook.payload = {
        attachments: [{
          color: "warning",
          title: "⚠️ Subscription Cancelled",
          fields: [
            {
              title: "Customer",
              value: webhook.payload.data.customer.email,
              short: true
            },
            {
              title: "Product ID",
              value: webhook.payload.data.product_id,
              short: true
            },
            {
              title: "Cancellation Date",
              value: new Date(webhook.payload.data.cancelled_at).toLocaleDateString(),
              short: true
            },
            {
              title: "Cancel at Next Billing",
              value: webhook.payload.data.cancel_at_next_billing_date ? "Yes" : "No",
              short: true
            }
          ],
          footer: "Dodo Payments",
          ts: Math.floor(new Date(webhook.payload.timestamp).getTime() / 1000)
        }]
      };
      break;
      
    case "subscription.renewed":
      webhook.payload = {
        attachments: [{
          color: "good",
          title: "🔄 Subscription Renewed",
          fields: [
            {
              title: "Customer",
              value: webhook.payload.data.customer.email,
              short: true
            },
            {
              title: "Product ID",
              value: webhook.payload.data.product_id,
              short: true
            },
            {
              title: "Amount",
              value: `${(webhook.payload.data.recurring_pre_tax_amount / 100).toFixed(2)} ${webhook.payload.data.currency}`,
              short: true
            },
            {
              title: "Next Billing",
              value: new Date(webhook.payload.data.next_billing_date).toLocaleDateString(),
              short: true
            }
          ],
          footer: "Dodo Payments",
          ts: Math.floor(new Date(webhook.payload.timestamp).getTime() / 1000)
        }]
      };
      break;
  }

  return webhook;
}

Notifiche per la gestione delle contestazioni

Pubblica un messaggio rosso quando si apre una contestazione o questa viene persa, e uno verde quando viene vinta: CODE_PLACEHOLDER_817da398e87e97b_END

Handler completo per tutti gli eventi

Pubblica un messaggio nello stesso formato per ogni tipo di evento. Gli eventi senza un proprio case ricevono un messaggio generico con il tipo e l’ora dell’evento:

all_events_notifs.js

function handler(webhook) {
  const event = webhook.payload.data;
  const timestamp = new Date(webhook.payload.timestamp).toLocaleString();
  
  let color, emoji, title, fields = [];
  
  switch (webhook.eventType) {
    case "payment.succeeded":
      color = "good";
      emoji = "✅";
      title = "Payment Successful";
      fields = [
        { title: "Amount", value: `${(event.total_amount / 100).toFixed(2)} ${event.currency}`, short: true },
        { title: "Customer", value: event.customer.email, short: true },
        { title: "Payment ID", value: event.payment_id, short: true },
        { title: "Method", value: event.payment_method || "Unknown", short: true }
      ];
      break;
      
    case "payment.failed":
      color = "danger";
      emoji = "❌";
      title = "Payment Failed";
      fields = [
        { title: "Amount", value: `${(event.total_amount / 100).toFixed(2)} ${event.currency}`, short: true },
        { title: "Customer", value: event.customer.email, short: true },
        { title: "Reason", value: event.error_message || "Unknown", short: false }
      ];
      break;
      
    case "subscription.active":
      color = "good";
      emoji = "🎉";
      title = "Subscription Activated";
      fields = [
        { title: "Customer", value: event.customer.email, short: true },
        { title: "Product ID", value: event.product_id, short: true },
        { title: "Amount", value: `${(event.recurring_pre_tax_amount / 100).toFixed(2)} ${event.currency}/${event.payment_frequency_interval}`, short: true },
        { title: "Next Billing", value: new Date(event.next_billing_date).toLocaleDateString(), short: true }
      ];
      break;
      
    case "subscription.cancelled":
      color = "warning";
      emoji = "⚠️";
      title = "Subscription Cancelled";
      fields = [
        { title: "Customer", value: event.customer.email, short: true },
        { title: "Product ID", value: event.product_id, short: true },
        { title: "Cancellation Date", value: new Date(event.cancelled_at).toLocaleDateString(), short: true },
        { title: "Cancel at Next Billing", value: event.cancel_at_next_billing_date ? "Yes" : "No", short: true }
      ];
      break;
      
    case "refund.succeeded":
      color = "good";
      emoji = "💰";
      title = "Refund Processed";
      fields = [
        { title: "Amount", value: `${(event.amount / 100).toFixed(2)} ${event.currency || ""}`, short: true },
        { title: "Refund ID", value: event.refund_id, short: true },
        { title: "Payment ID", value: event.payment_id, short: true },
        { title: "Reason", value: event.reason || "Not specified", short: true }
      ];
      break;
      
    case "dispute.opened":
      color = "danger";
      emoji = "🚨";
      title = "New Dispute Opened";
      fields = [
        { title: "Payment ID", value: event.payment_id, short: true },
        { title: "Amount", value: `${(event.amount / 100).toFixed(2)} ${event.currency}`, short: true },
        { title: "Status", value: event.dispute_status, short: true },
        { title: "Stage", value: event.dispute_stage, short: true },
        { title: "Remarks", value: event.remarks || "No remarks", short: false }
      ];
      break;
      
    case "license_key.created":
      color = "good";
      emoji = "🔑";
      title = "License Key Created";
      fields = [
        { title: "License ID", value: event.id, short: true },
        { title: "Product ID", value: event.product_id, short: true },
        { title: "License Key", value: event.key.substring(0, 8) + "****", short: true },
        { title: "Expires", value: event.expires_at ? new Date(event.expires_at).toLocaleDateString() : "Never", short: true }
      ];
      break;
      
    default:
      // Handle any other events with a generic format
      color = "#3aa3e3";
      emoji = "ℹ️";
      title = webhook.eventType.replace(/_/g, ' ').replace(/\b\w/g, l => l.toUpperCase());
      fields = [
        { title: "Event Type", value: webhook.eventType, short: true },
        { title: "Timestamp", value: timestamp, short: true }
      ];
  }
  
  webhook.payload = {
    attachments: [{
      color: color,
      title: `${emoji} ${title}`,
      fields: fields,
      footer: "Dodo Payments",
      ts: Math.floor(new Date(webhook.payload.timestamp).getTime() / 1000)
    }]
  };

  return webhook;
}

Best practice

Segui queste pratiche per mantenere utili le notifiche Slack:

Usa allegati dei messaggi con colori e campi, in modo che ogni evento sia chiaro e sia facile intervenire.
Includi dati chiave come l’importo, l’email del cliente e gli ID, così il tuo team può trovare rapidamente il record.
Abbina il colore al tipo di evento: verde (good) per i successi, rosso (danger) per le contestazioni o gli errori, giallo (warning) per gli annullamenti e blu (#3aa3e3) per gli eventi informativi.
Aggiungi un timestamp (ts), così ogni messaggio mostra quando si è verificato l’evento.

Gestisci i dati sensibili: non pubblicare su Slack valori sensibili come chiavi di licenza complete o dati personali. Tronca o maschera questi valori, come avviene per il campo della chiave di licenza nell’esempio per tutti gli eventi.

Risoluzione dei problemi

Notifications Not Appearing in Slack

Verifica che l’URL del webhook Slack sia corretto e che la relativa app Slack sia ancora installata.
Verifica che il codice di trasformazione sia JavaScript valido.
Verifica che gli eventi sottoscritti si stiano verificando. Per inviarne uno, usa Send example nella scheda Testing dell’endpoint.
Verifica che nella tua app Slack siano attivati gli Incoming Webhooks e che possa pubblicare nel canale.

Transformation Errors

Apri la scheda Logs in Developer → Webhooks e controlla la risposta della consegna non riuscita.
Verifica che i campi del payload letti dal tuo codice corrispondano all’event payload per quel tipo di evento.
Testa il codice con Simulate e un payload di esempio.
Verifica che ogni campo letto dal codice sia presente. I campi facoltativi, come error_message, possono essere null.

Missing Event Types

Verifica che l’evento sia selezionato in Subscribed events. Per modificare la selezione, apri l’endpoint e fai clic su Edit.
Verifica che il connettore Slack supporti l’evento. Subscribed events elenca solo gli eventi supportati dal connettore.
Verifica che la trasformazione includa un case per l’evento. Gli esempi lasciano invariati gli altri eventi, che Slack rifiuta.

External Integrations

Messaging

Workflow Automation

CRM

Email

Analytics

Pricing

Introduzione

Iniziare

Esempi di codice di trasformazione

Notifiche di pagamento di base

Notifiche dettagliate degli abbonamenti

Notifiche per la gestione delle contestazioni

Handler completo per tutti gli eventi

Best practice

Risoluzione dei problemi

​Introduzione

​Iniziare

​Esempi di codice di trasformazione

​Notifiche di pagamento di base

​Notifiche dettagliate degli abbonamenti

​Notifiche per la gestione delle contestazioni

​Handler completo per tutti gli eventi

​Best practice

​Risoluzione dei problemi

Introduzione

Iniziare

Esempi di codice di trasformazione

Notifiche di pagamento di base

Notifiche dettagliate degli abbonamenti

Notifiche per la gestione delle contestazioni

Handler completo per tutti gli eventi

Best practice

Risoluzione dei problemi