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
    }
  ]
}