Invia SMS

POST https://api.brevo.com/v3/transactionalSMS/sms
Content-Type: application/json
api-key: YOUR_API_KEY

{
  "type": "transactional",
  "unicodeEnabled": false,
  "sender": "TajoLoyalty",
  "recipient": "+1234567890",
  "content": "Ciao Mario! Hai guadagnato 150 punti dal tuo recente acquisto. Totale: 1.250 punti. Riscatta su tajo.com/rewards"
}

{
  "reference": "sms_abc123",
  "messageId": "msg_def456"
}

{
  "type": "transactional",
  "sender": "TajoRewards",
  "recipient": "+1234567890",
  "content": "🎉 Ottima notizia {{contact.FIRSTNAME}}! Hai guadagnato {{params.pointsEarned}} punti dall'ordine #{{params.orderNumber}}. Totale: {{params.totalPoints}} punti. Acquista ancora su {{params.storeUrl}}",
  "params": {
    "pointsEarned": "200",
    "orderNumber": "ORD-2024-001",
    "totalPoints": "1.450",
    "storeUrl": "shop.tajo.com"
  }
}

{
  "content": "🌟 Congratulazioni {{contact.FIRSTNAME}}! Sei stato promosso al livello {{params.newTier}}! Goditi {{params.benefits}}. Il tuo nuovo saldo punti: {{params.totalPoints}}",
  "params": {
    "newTier": "Gold",
    "benefits": "spedizione gratuita e offerte esclusive",
    "totalPoints": "2.500"
  }
}

{
  "content": "✅ Premio riscattato! {{params.rewardName}} - {{params.pointsUsed}} punti utilizzati. Coupon: {{params.couponCode}} (scade {{params.expiryDate}}). Rimanenti: {{params.remainingPoints}} punti",
  "params": {
    "rewardName": "20% di Sconto",
    "pointsUsed": "1000",
    "couponCode": "SAVE20NOW",
    "expiryDate": "15 mar",
    "remainingPoints": "450"
  }
}

{
  "content": "📦 Il tuo ordine #{{params.orderNumber}} è stato {{params.status}}! {{params.details}} Traccia: {{params.trackingUrl}}",
  "params": {
    "orderNumber": "ORD-2024-001",
    "status": "spedito",
    "details": "In arrivo in 2-3 giorni lavorativi",
    "trackingUrl": "track.tajo.com/ORD-2024-001"
  }
}

{
  "type": "marketing",
  "sender": "TajoBday",
  "recipient": "+1234567890",
  "content": "🎂 Buon Compleanno {{contact.FIRSTNAME}}! Ecco un regalo speciale: {{params.birthdayBonus}} punti bonus + {{params.discountCode}} per {{params.discountAmount}} di sconto! Valido fino a {{params.expiryDate}}",
  "params": {
    "birthdayBonus": "500",
    "discountCode": "BIRTHDAY25",
    "discountAmount": "25%",
    "expiryDate": "fine mese"
  }
}

{
  "content": "🛒 Ciao {{contact.FIRSTNAME}}, hai lasciato {{params.itemCount}} articoli nel carrello del valore di {{params.cartValue}}. Completa l'acquisto e guadagna {{params.potentialPoints}} punti! Continua: {{params.cartUrl}}",
  "params": {
    "itemCount": "3",
    "cartValue": "€299.97",
    "potentialPoints": "300",
    "cartUrl": "tajo.com/cart"
  }
}

{
  "content": "⚡ {{contact.FIRSTNAME}}, FLASH SALE: {{params.saleDetails}}! I membri {{params.loyaltyTier}} ricevono {{params.bonusPoints}} punti bonus! Acquista ora: {{params.saleUrl}} ({{params.timeLeft}} rimanenti)",
  "params": {
    "saleDetails": "50% di sconto sull'elettronica",
    "loyaltyTier": "Gold",
    "bonusPoints": "doppi",
    "saleUrl": "tajo.com/flash",
    "timeLeft": "6 ore"
  }
}

{
  "type": "transactional",
  "templateId": 123,
  "params": {
    "customerName": "Mario Rossi",
    "pointsBalance": "2.350",
    "nextReward": "Spedizione gratuita a 2.500 punti"
  }
}

{
  "type": "transactional",
  "sender": "TajoRemind",
  "recipient": "+1234567890",
  "content": "⏰ Promemoria: I tuoi {{params.pointsExpiring}} punti scadono tra {{params.daysLeft}} giorni! Usali su tajo.com/rewards",
  "scheduledAt": "2024-01-30T09:00:00Z",
  "params": {
    "pointsExpiring": "500",
    "daysLeft": "7"
  }
}

{
  "type": "transactional",
  "content": "Benvenuto agli avvisi SMS Tajo! Rispondi SÌ per confermare che vuoi aggiornamenti sulla fedeltà e offerte esclusive. Rispondi STOP per disiscriverti in qualsiasi momento."
}

{
  "type": "transactional",
  "content": "Sei stato cancellato dagli avvisi SMS Tajo. Riceverai ancora importanti aggiornamenti sugli ordini. Per iscriverti nuovamente, invia INIZIO. Domande? Contatta [email protected]"
}

{
  "code": "invalid_recipient",
  "message": "Phone number format invalid",
  "details": {
    "recipient": "123-456-7890",
    "expectedFormat": "+1234567890"
  }
}

{
  "code": "message_too_long",
  "message": "SMS content exceeds character limit",
  "details": {
    "length": 180,
    "limit": 160,
    "segments": 2
  }
}