Enviar 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": "Olá João! Ganhou 150 pontos na sua compra recente. Total: 1.250 pontos. Resgate em tajo.com/rewards"
}

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

{
  "type": "transactional",
  "sender": "TajoRewards",
  "recipient": "+1234567890",
  "content": "🎉 Boa notícia {{contact.FIRSTNAME}}! Ganhou {{params.pointsEarned}} pontos do pedido #{{params.orderNumber}}. Total: {{params.totalPoints}} pontos. Compre mais em {{params.storeUrl}}",
  "params": {
    "pointsEarned": "200",
    "orderNumber": "ORD-2024-001",
    "totalPoints": "1.450",
    "storeUrl": "shop.tajo.com"
  }
}

{
  "content": "🌟 Parabéns {{contact.FIRSTNAME}}! Foi promovido ao estatuto {{params.newTier}}! Desfrute de {{params.benefits}}. O seu novo saldo de pontos: {{params.totalPoints}}",
  "params": {
    "newTier": "Gold",
    "benefits": "envio gratuito e ofertas exclusivas",
    "totalPoints": "2.500"
  }
}

{
  "content": "✅ Recompensa resgatada! {{params.rewardName}}, {{params.pointsUsed}} pontos usados. Cupão: {{params.couponCode}} (expira {{params.expiryDate}}). Restante: {{params.remainingPoints}} pontos",
  "params": {
    "rewardName": "20% de Desconto",
    "pointsUsed": "1000",
    "couponCode": "SAVE20NOW",
    "expiryDate": "15 Mar",
    "remainingPoints": "450"
  }
}

{
  "content": "📦 O seu pedido #{{params.orderNumber}} foi {{params.status}}! {{params.details}} Rastreie em: {{params.trackingUrl}}",
  "params": {
    "orderNumber": "ORD-2024-001",
    "status": "enviado",
    "details": "Chega em 2-3 dias úteis",
    "trackingUrl": "track.tajo.com/ORD-2024-001"
  }
}

{
  "type": "marketing",
  "sender": "TajoBday",
  "recipient": "+1234567890",
  "content": "🎂 Feliz Aniversário {{contact.FIRSTNAME}}! Aqui está um presente especial: {{params.birthdayBonus}} pontos bónus + {{params.discountCode}} para {{params.discountAmount}} de desconto! Válido até {{params.expiryDate}}",
  "params": {
    "birthdayBonus": "500",
    "discountCode": "BIRTHDAY25",
    "discountAmount": "25%",
    "expiryDate": "fim do mês"
  }
}

{
  "content": "🛒 Olá {{contact.FIRSTNAME}}, deixou {{params.itemCount}} artigos no seu carrinho no valor de {{params.cartValue}}. Conclua a compra e ganhe {{params.potentialPoints}} pontos! Continue: {{params.cartUrl}}",
  "params": {
    "itemCount": "3",
    "cartValue": "$299,97",
    "potentialPoints": "300",
    "cartUrl": "tajo.com/cart"
  }
}

{
  "content": "⚡ {{contact.FIRSTNAME}}, VENDA FLASH: {{params.saleDetails}}! Membros {{params.loyaltyTier}} recebem {{params.bonusPoints}} pontos bónus! Compre agora: {{params.saleUrl}} (resta {{params.timeLeft}})",
  "params": {
    "saleDetails": "50% de desconto em eletrónica",
    "loyaltyTier": "Gold",
    "bonusPoints": "duplos",
    "saleUrl": "tajo.com/flash",
    "timeLeft": "6 horas"
  }
}

{
  "type": "transactional",
  "templateId": 123,
  "params": {
    "customerName": "John Doe",
    "pointsBalance": "2.350",
    "nextReward": "Envio gratuito a 2.500 pontos"
  }
}

{
  "type": "transactional",
  "sender": "TajoRemind",
  "recipient": "+1234567890",
  "content": "⏰ Lembrete: Os seus {{params.pointsExpiring}} pontos expiram em {{params.daysLeft}} dias! Use-os em tajo.com/rewards",
  "scheduledAt": "2024-01-30T09:00:00Z",
  "params": {
    "pointsExpiring": "500",
    "daysLeft": "7"
  }
}

{
  "type": "transactional",
  "unicodeEnabled": true,
  "content": "🎊 ¡Felicidades {{contact.FIRSTNAME}}! Has ganado {{params.points}} puntos 💎",
  "params": {
    "points": "150"
  }
}

{
  "type": "marketing",
  "content": "{{#if contact.LOYALTY_TIER == 'Platinum'}}💎 Alerta VIP: Acesso antecipado à nossa saldos + pontos triplos!{{else}}🌟 Membro de fidelidade: Obtenha pontos duplos na sua próxima compra!{{/if}}",
  "webUrl": "https://tajo.com/sale"
}

{
  "content": "📍 {{contact.FIRSTNAME}}, há uma loja Tajo perto de si! Visite {{params.nearestStore}} e mostre este texto para {{params.inStoreBonus}} pontos bónus!",
  "params": {
    "nearestStore": "Rua Principal 123, Lisboa",
    "inStoreBonus": "100"
  }
}

{
  "type": "transactional",
  "content": "Bem-vindo aos alertas SMS Tajo! Responda SIM para confirmar que quer atualizações de fidelidade e ofertas exclusivas. Responda PARAR para cancelar subscrição a qualquer momento. Podem ser aplicadas taxas de dados."
}

{
  "type": "transactional",
  "content": "Cancelou a subscrição dos alertas SMS Tajo. Continuará a receber atualizações importantes de pedidos. Para voltar a subscrever, envie INICIAR. Dúvidas? Contacte [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
  }
}

{
  "content": "Olá {{contact.FIRSTNAME}}! +{{params.points}}pts do pedido #{{params.orderNum}}. Total: {{params.total}}pts. tajo.com/rewards",
  "estimatedSegments": 1,
  "characterCount": 89
}

{
  "recipients": [
    {
      "phone": "+1234567890",
      "params": { "name": "João", "points": "150" }
    },
    {
      "phone": "+1234567891",
      "params": { "name": "Maria", "points": "200" }
    }
  ],
  "content": "Olá {{params.name}}! Ganhou {{params.points}} pontos!"
}