Alterando notificações de um cliente
Cada cliente possui configurações de notificação e o Asaas sempre olhará para elas quando uma nova cobrança for criada. Você pode ligar ou desligar notificações, mudar a quantos dias antes elas serão enviadas ou definir que tipo de notificações acontecerão sempre que criar um novo cliente.
O primeiro passo, depois de ter criado seu cliente é verificar quais notificações foram criadas. Para isso basta chamar o endpoint "Recuperar notificações de um cliente".
GET
/v3/customers/{id}/notifications
Confira a referência completa deste endpoint.
Ao chamar este endpoint, uma lista com todas as notificações criadas para este cliente será retornada:
{
"object": "list",
"hasMore": false,
"totalCount": 8,
"limit": 10,
"offset": 0,
"data": [
{
"object": "notification",
"id": "not_000042762597",
"customer": "cus_000005358829",
"enabled": true,
"emailEnabledForProvider": true,
"smsEnabledForProvider": false,
"emailEnabledForCustomer": true,
"smsEnabledForCustomer": true,
"phoneCallEnabledForCustomer": false,
"whatsappEnabledForCustomer": false,
"event": "PAYMENT_RECEIVED",
"scheduleOffset": 0,
"deleted": false
},
{
"object": "notification",
"id": "not_000042762598",
"customer": "cus_000005358829",
"enabled": true,
"emailEnabledForProvider": true,
"smsEnabledForProvider": false,
"emailEnabledForCustomer": true,
"smsEnabledForCustomer": true,
"phoneCallEnabledForCustomer": false,
"whatsappEnabledForCustomer": false,
"event": "PAYMENT_OVERDUE",
"scheduleOffset": 0,
"deleted": false
},
{
"object": "notification",
"id": "not_000042762602",
"customer": "cus_000005358829",
"enabled": true,
"emailEnabledForProvider": false,
"smsEnabledForProvider": false,
"emailEnabledForCustomer": true,
"smsEnabledForCustomer": true,
"phoneCallEnabledForCustomer": false,
"whatsappEnabledForCustomer": false,
"event": "PAYMENT_DUEDATE_WARNING",
"scheduleOffset": 10,
"deleted": false
},
{
"object": "notification",
"id": "not_000042762601",
"customer": "cus_000005358829",
"enabled": true,
"emailEnabledForProvider": false,
"smsEnabledForProvider": false,
"emailEnabledForCustomer": true,
"smsEnabledForCustomer": true,
"phoneCallEnabledForCustomer": false,
"whatsappEnabledForCustomer": false,
"event": "PAYMENT_DUEDATE_WARNING",
"scheduleOffset": 0,
"deleted": false
},
{
"object": "notification",
"id": "not_000042762599",
"customer": "cus_000005358829",
"enabled": true,
"emailEnabledForProvider": false,
"smsEnabledForProvider": false,
"emailEnabledForCustomer": true,
"smsEnabledForCustomer": true,
"phoneCallEnabledForCustomer": false,
"whatsappEnabledForCustomer": false,
"event": "PAYMENT_CREATED",
"scheduleOffset": 0,
"deleted": false
},
{
"object": "notification",
"id": "not_000042762600",
"customer": "cus_000005358829",
"enabled": true,
"emailEnabledForProvider": false,
"smsEnabledForProvider": false,
"emailEnabledForCustomer": true,
"smsEnabledForCustomer": true,
"phoneCallEnabledForCustomer": false,
"whatsappEnabledForCustomer": false,
"event": "PAYMENT_UPDATED",
"scheduleOffset": 0,
"deleted": false
},
{
"object": "notification",
"id": "not_000042762604",
"customer": "cus_000005358829",
"enabled": true,
"emailEnabledForProvider": false,
"smsEnabledForProvider": false,
"emailEnabledForCustomer": true,
"smsEnabledForCustomer": true,
"phoneCallEnabledForCustomer": false,
"whatsappEnabledForCustomer": false,
"event": "SEND_LINHA_DIGITAVEL",
"scheduleOffset": 0,
"deleted": false
},
{
"object": "notification",
"id": "not_000042762603",
"customer": "cus_000005358829",
"enabled": true,
"emailEnabledForProvider": false,
"smsEnabledForProvider": false,
"emailEnabledForCustomer": true,
"smsEnabledForCustomer": true,
"phoneCallEnabledForCustomer": false,
"whatsappEnabledForCustomer": false,
"event": "PAYMENT_OVERDUE",
"scheduleOffset": 7,
"deleted": false
}
]
}
Tendo em mão os o ID de cada notificação você pode editá-la.
As notificações são fixas e criadas pelo Asaas não é possível excluí-las ou criar novas, apenas alterar.
Você pode escolher editar apenas uma notificação, fazendo a chamada ao endpoint "Atualizar notificação existente":
POST
/v3/notifications/not_000042762599
Confira a referência completa deste endpoint.
{
"enabled": true,
"emailEnabledForProvider": false,
"smsEnabledForProvider": false,
"emailEnabledForCustomer": true,
"smsEnabledForCustomer": false,
"phoneCallEnabledForCustomer": false,
"whatsappEnabledForCustomer": false
}
No exemplo acima modificamos a notificação de criação de pagamento para enviar somente um e-mail ao cliente.
Você também pode alterar todas as notificações juntas e deixar somente as notificações que você quiser ativadas, por exemplo, usando o endpoint "Atualizar notificações em lote":
POST
/v3/notifications/batch
Confira a referência completa deste endpoint.
{
"customer": "cus_Y4AEif5zrMGK",
"notifications": [
{
"id": "not_f8JpoWuEjEKd",
"enabled": true,
"emailEnabledForProvider": true,
"smsEnabledForProvider": true,
"emailEnabledForCustomer": true,
"smsEnabledForCustomer": true,
"phoneCallEnabledForCustomer": false,
"whatsappEnabledForCustomer": false
},
{
"id": "not_f8JpoWuEjEKd",
"enabled": true,
"emailEnabledForProvider": true,
"smsEnabledForProvider": true,
"emailEnabledForCustomer": true,
"smsEnabledForCustomer": true,
"phoneCallEnabledForCustomer": false,
"whatsappEnabledForCustomer": false
}
]
}
Updated 10 months ago