Twilio
Overview
O custo vem da própria Twilio (Usage/Records), pela categoria agregada totalprice — o total cobrado do mês, com subcontas incluídas. Lê os últimos 3 meses.
Por que só o total do mês
A Twilio devolve centenas de categorias encaixadas umas nas outras (sms contém sms-outbound). Somar tudo contaria o mesmo gasto várias vezes. Por isso o conector usa só o total oficial. A quebra por produto fica para uma versão futura.
Em calibração
Conferido só com uma conta sem cobrança. Até a primeira cobrança ser conferida contra a fatura, o card aparece como Em calibração.
Requisitos
- O Account SID (
AC…) - Uma Restricted API Key (
SK…+ secret) só com leitura de Usage Records. Ela não envia SMS nem faz ligação. O Auth Token e as chaves Main/Standard nunca são pedidos. - Ser o dono da conta no CloudBroker, com papel de administrador
Campos
| Campo | Obrigatório | Descrição |
|---|---|---|
accountSid | Sim | Account SID (AC…) |
apiKeySid | Sim | SID da chave restrita (SK…) |
apiKeySecret | Sim | Secret da chave restrita |
appId | Não | Atribui o custo a um app do CloudBroker |
Dado coletado
- Total cobrado por mês, em USD.
- Mês anterior à criação da conta aparece como sem registro, nunca como US$ 0.
- Moeda diferente de USD ou linha inesperada marca a leitura como incompleta.
Segurança
O secret é cifrado com AES-256-GCM antes de persistir.