Skip to main content
Este documento descreve os payloads de webhook relacionados a comunicações com clientes.

​
Cupons

Enviado quando uma comunicação é disparada referente a cupons disponíveis para o cliente usar.
{
  "CouponType": 1,
  "ValidDateEnd": "2025-12-31T23:59:59Z",
  "CouponValue": 10.00,
  "CouponCode": "BEMVINDO10",
  "Customer": { ... }
}
​
CouponType
number
required
Tipo do cupom. Veja CouponType
​
ValidDateEnd
string
Data de expiração (ISO 8601), se houver. Pode ser null.
​
CouponValue
number
required
Valor do cupom (ex: 10.0 para 10% ou R$10,00)
​
CouponCode
string
required
Código para resgate
​
Customer
object
required
Objeto Cliente

​
Resgate de Recompensas

Enviado após um cliente resgatar pontos por uma recompensa personalizada.
{
  "Points": 500,
  "RewardDescription": "Caneca Grátis com Logo",
  "Coupon": "RESGATECAN123",
  "Customer": { ... }
}
​
Points
number
required
Pontos gastos no resgate
​
RewardDescription
string
required
Descrição da recompensa
​
Coupon
string
Código de cupom gerado, se aplicável. Pode ser null.
​
Customer
object
required
Objeto Cliente

​
Ganho de Pontos

Estes tópicos são enviados quando um cliente ganha pontos. A estrutura varia conforme o tipo de objetivo. Campos Base Comuns:
​
EarnedPoints
number
required
Pontos ganhos neste evento
​
ObjectiveType
number
required
Tipo de objetivo. Veja ObjectiveType
​
Customer
object
required
Objeto Cliente
Ganho de pontos por uma compra.
{
  "EarnedPoints": 150,
  "ObjectiveType": 0,
  "Customer": { ... },
  "CashbackEarned": 1.50,
  "ValidDate": "2026-04-15T00:00:00Z",
  "OrderDate": "2025-04-15T10:05:00Z",
  "OrderValue": 150.00,
  "PercentCashbackEarned": 0.01,
  "Date": "2025-04-15T10:05:10Z",
  "OrderId": "pedido_123",
  "PointId": 98765
}
Campos Adicionais:
​
CashbackEarned
number
Cashback ganho
​
ValidDate
string
Expiração dos pontos/cashback
​
OrderDate
string
required
Data do pedido
​
OrderValue
number
required
Valor total do pedido
​
PercentCashbackEarned
number
Taxa de cashback (ex: 0.01 = 1%)
​
Date
string
required
Data do registro do evento
​
OrderId
string
required
ID do pedido no sistema de origem
​
PointId
number
required
ID interno do registro de ponto
Ganho de pontos como bônus de aniversário.
{
  "EarnedPoints": 100,
  "ObjectiveType": 2,
  "Customer": { ... },
  "BirthdayPoints": 100,
  "BirthdayBonification": "Bônus Feliz Aniversário!",
  "CouponType": 1,
  "CouponCode": "NIVERPRESENTE",
  "RedeemUrl": "https://exemplo.com/resgatar-niver"
}
Campos Adicionais:
​
BirthdayPoints
number
required
Pontos do aniversário
​
BirthdayBonification
string
Descrição do bônus
​
CouponType
number
Tipo do cupom concedido
​
CouponCode
string
Código do cupom
​
RedeemUrl
string
URL para resgate
Ganho de pontos por cadastro. Usa apenas os campos base comuns.
Ganho de pontos por review. Usa apenas os campos base comuns.
Ganho de pontos por indicação.
{
  "EarnedPoints": 200,
  "ObjectiveType": 4,
  "Customer": { ... },
  "FriendName": "Maria Souza"
}
Campo Adicional:
​
FriendName
string
Nome do amigo indicado
Ganho de pontos por quiz. Usa apenas os campos base comuns.
Ganho de pontos por objetivo personalizado. Usa apenas os campos base comuns.
Os tópicos abaixo usam a estrutura base comum:
  • Communication_EarnSocialMediaFollowInstagram (ObjectiveType: 5)
  • Communication_EarnSocialMediaFollowFacebook (ObjectiveType: 6)
  • Communication_EarnSocialMediaFollowLinkedin (ObjectiveType: 9)
  • Communication_EarnSocialMediaFollowTikTok (ObjectiveType: 10)

​
Alteração de Pontos

Enviado quando há alteração manual ou diversa no saldo de pontos.
{
  "Points": -50,
  "PointsValidDate": "01/08/2025",
  "Customer": { ... }
}
​
Points
number
required
Pontos da alteração (positivo = adição, negativo = subtração)
​
PointsValidDate
string
required
Data de expiração formatada
​
Customer
object
required
Objeto Cliente

​
Pontos Disponíveis

Enviado para informar o cliente sobre seu potencial de resgate.
{
  "PointsToUse": 1500,
  "MaxValueDiscount": "R$ 15,00",
  "MaxPercentDiscount": "10%",
  "Customer": { ... }
}
​
PointsToUse
number
required
Total de pontos disponíveis
​
MaxValueDiscount
string
required
Desconto monetário máximo formatado
​
MaxPercentDiscount
string
required
Desconto percentual máximo formatado
​
Customer
object
required
Objeto Cliente

​
Expiração de Pontos

Enviado para notificar sobre pontos próximos da expiração.
{
  "PointsToExpire": 250,
  "ExpirationAt": "2025-07-31T23:59:59Z",
  "ExpirationDate": "31/07/2025",
  "Customer": { ... }
}
​
PointsToExpire
number
required
Quantidade de pontos que expirarão
​
ExpirationAt
string
required
Data/hora de expiração (ISO 8601)
​
ExpirationDate
string
required
Data formatada para exibição
​
Customer
object
required
Objeto Cliente

​
Resgate de Pontos

Enviado após resgate de pontos por recompensa padrão.
{
  "CouponCode": "RESGATE5OFF",
  "CouponDescription": "Cupom de Desconto R$ 5,00",
  "Points": 500,
  "Customer": { ... }
}
​
CouponCode
string
required
Código do cupom gerado
​
CouponDescription
string
required
Descrição da recompensa
​
Points
number
required
Pontos gastos
​
Customer
object
required
Objeto Cliente

​
OTP (Código de Verificação)

Enviado quando um código OTP é enviado ao cliente.
Nota de Segurança: Seja cauteloso ao processar OTPs via webhooks. Garanta que seu endpoint e lógica sejam seguros.
{
  "Otp": "123456",
  "Customer": { ... }
}
​
Otp
string
required
Senha de uso único enviada
​
Customer
object
required
Objeto Cliente

​
Níveis/Tiers

Enviado quando o nível de fidelidade do cliente muda.
{
  "TierName": "Ouro",
  "Benefits": [
    "Frete Grátis em todos os pedidos",
    "Acesso antecipado a promoções"
  ],
  "NextTierTargets": [
    "Gastar R$ 5000 nos próximos 6 meses"
  ],
  "Customer": { ... }
}
​
TierName
string
required
Nome do novo nível
​
Benefits
array
required
Lista de benefícios do nível
​
NextTierTargets
array
required
Requisitos para próximo nível (vazio se for o mais alto)
​
Customer
object
required
Objeto Cliente
Documentação atualizada em Dezembro de 2025.