# SMSGo.com.br ## API Docs - Raiz > Autenticação [Trocar SMSGo-key por token Bearer](https://smsgo.apidog.io/trocar-smsgo-key-por-token-bearer-39041496e0.md): Recebe a chave permanente no header `SMSGo-key` e retorna um token Bearer válido por 48h. - Raiz > Autenticação [Revogar o token atual](https://smsgo.apidog.io/revogar-o-token-atual-39041497e0.md): - Raiz > SMS [Enviar um SMS](https://smsgo.apidog.io/enviar-um-sms-39041498e0.md): Envia uma mensagem para um número. Debita o saldo da conta. - Raiz > SMS [Enviar SMS em massa](https://smsgo.apidog.io/enviar-sms-em-massa-39041499e0.md): Envia várias mensagens em uma transação única (até 5000). Debita o total do saldo. - Raiz > SMS [Listar envios](https://smsgo.apidog.io/listar-envios-39041500e0.md): - Raiz > SMS [Detalhar um envio](https://smsgo.apidog.io/detalhar-um-envio-39041501e0.md): Retorna o envio, seus números e um objeto `summary` de acompanhamento com as contagens por bucket de status: `{ total, delivered, failed, inProgress, done }`. `done` é `true` quando nenhum número está mais em andamento (processo encerrado). - Raiz > SMS [Listar números de um envio (paginado)](https://smsgo.apidog.io/listar-n%C3%BAmeros-de-um-envio-paginado-39041502e0.md): Lista paginada dos números do envio, para acompanhar envios grandes sem baixar tudo de uma vez. Filtre por bucket de status com `status`. - Raiz > SMS [Catálogo de tipos de SMS](https://smsgo.apidog.io/cat%C3%A1logo-de-tipos-de-sms-39041503e0.md): Lista os tipos de SMS ativos com preço. O `id` numérico é o valor a enviar no campo `sms_type_id` dos endpoints de envio. - Raiz > Contatos [Listar contatos](https://smsgo.apidog.io/listar-contatos-39041504e0.md): - Raiz > Contatos [Criar contato](https://smsgo.apidog.io/criar-contato-39041505e0.md): Cria (ou faz upsert pelo telefone) um contato. Retorna o UUID do contato. - Raiz > Contatos [Detalhar contato](https://smsgo.apidog.io/detalhar-contato-39041506e0.md): - Raiz > Contatos [Atualizar contato](https://smsgo.apidog.io/atualizar-contato-39041507e0.md): - Raiz > Contatos [Excluir contato](https://smsgo.apidog.io/excluir-contato-39041508e0.md): - Raiz > Listas [Listar listas](https://smsgo.apidog.io/listar-listas-39041509e0.md): - Raiz > Listas [Criar lista](https://smsgo.apidog.io/criar-lista-39041510e0.md): - Raiz > Listas [Detalhar lista](https://smsgo.apidog.io/detalhar-lista-39041511e0.md): - Raiz > Listas [Atualizar lista](https://smsgo.apidog.io/atualizar-lista-39041512e0.md): - Raiz > Listas [Excluir lista](https://smsgo.apidog.io/excluir-lista-39041513e0.md): - Raiz > Conta [Consultar saldo da conta](https://smsgo.apidog.io/consultar-saldo-da-conta-39041514e0.md): Retorna o saldo monetário (R$) disponível e os dados básicos da conta. - Raiz > Conta [Ler configuração de recarga automática](https://smsgo.apidog.io/ler-configura%C3%A7%C3%A3o-de-recarga-autom%C3%A1tica-39041515e0.md): - Raiz > Conta [Atualizar recarga automática + alerta de saldo](https://smsgo.apidog.io/atualizar-recarga-autom%C3%A1tica-alerta-de-saldo-39041516e0.md): Define o limiar de recarga (`threshold`), o plano (`plan_quantity`), o cartão (`card_id`) e o alerta de saldo (`alert_enabled` + `alert_threshold`). Para LIGAR a recarga é obrigatório `card_id` + `plan_quantity`. - Raiz > Conta [Ler webhook de saída](https://smsgo.apidog.io/ler-webhook-de-sa%C3%ADda-39041517e0.md): - Raiz > Conta [Definir webhook de saída (DLR + respostas)](https://smsgo.apidog.io/definir-webhook-de-sa%C3%ADda-dlr-respostas-39041518e0.md): Define a URL que receberá os eventos `sms.status` e `sms.reply`. Gera um segredo de assinatura na 1ª vez; use `rotate_secret` para girar. URL vazia desativa o webhook. - Raiz > Faturamento [Pacotes de recarga](https://smsgo.apidog.io/pacotes-de-recarga-39041519e0.md): Lista os pacotes de créditos (tiers) disponíveis para compra, com preço unitário por faixa. - Raiz > Faturamento [Cartões salvos](https://smsgo.apidog.io/cart%C3%B5es-salvos-39041520e0.md): Lista os cartões de crédito salvos da conta (apenas os 4 últimos dígitos). - Raiz > Faturamento [Histórico de faturas](https://smsgo.apidog.io/hist%C3%B3rico-de-faturas-39041521e0.md): - Raiz > Faturamento [Comprar créditos (cartão salvo)](https://smsgo.apidog.io/comprar-cr%C3%A9ditos-cart%C3%A3o-salvo-39041522e0.md): Compra créditos cobrando um cartão salvo **sem o cliente presente** (off-session). Informe `quantity` (entre 250 e 1.000.000) ou `plan_id` (uuid de um pacote de `GET /v1/billing/plans`). Se `card_id` for omitido, usa o cartão padrão. `status=succeeded` já credita o saldo; `processing` confirma de forma assíncrona. ## Schemas - [SendResult](https://smsgo.apidog.io/sendresult-16120596d0.md): - [PurchaseResult](https://smsgo.apidog.io/purchaseresult-16120597d0.md): - [PaginationMeta](https://smsgo.apidog.io/paginationmeta-16120598d0.md): - [SendListItem](https://smsgo.apidog.io/sendlistitem-16120599d0.md): - [SendDetail](https://smsgo.apidog.io/senddetail-16120600d0.md): - [SendSummary](https://smsgo.apidog.io/sendsummary-16120601d0.md): - [SendNumberDetail](https://smsgo.apidog.io/sendnumberdetail-16120602d0.md): - [SendNumberItem](https://smsgo.apidog.io/sendnumberitem-16120603d0.md): - [ContactInput](https://smsgo.apidog.io/contactinput-16120604d0.md): - [ListInput](https://smsgo.apidog.io/listinput-16120605d0.md): - [ListResult](https://smsgo.apidog.io/listresult-16120606d0.md): - [Balance](https://smsgo.apidog.io/balance-16120607d0.md): - [SmsTypeItem](https://smsgo.apidog.io/smstypeitem-16120608d0.md): - [Plan](https://smsgo.apidog.io/plan-16120609d0.md): - [Card](https://smsgo.apidog.io/card-16120610d0.md): - [InvoiceItem](https://smsgo.apidog.io/invoiceitem-16120611d0.md): - [AutoRechargeConfig](https://smsgo.apidog.io/autorechargeconfig-16120612d0.md): - [WebhookConfig](https://smsgo.apidog.io/webhookconfig-16120613d0.md): - [WebhookStatusEvent](https://smsgo.apidog.io/webhookstatusevent-16120614d0.md): - [WebhookReplyEvent](https://smsgo.apidog.io/webhookreplyevent-16120615d0.md): - [Error](https://smsgo.apidog.io/error-16120616d0.md):