SMS · API de SMS

API de SMS: SMS a partir do seu software com um único pedido.

Envie SMS a partir do seu CRM, ERP, plataforma de comércio eletrónico ou aplicação própria, consulte o estado de entrega, receba as mensagens recebidas e as notificações de recusa. REST e JSON; autenticação com chave Bearer, eventos por webhook assinado com HMAC.

Candidate-se já Documentação da API de SMS

# SMS em massa personalizado curl -X POST https://api.buluthat.com/api/sms.php?action=send \ -H "Authorization: Bearer bt_xxx" -H "Content-Type: application/json" \ -d '{"header":"FIRMAADI","message":"Merhaba {ad}, siparişiniz kargoda.", "recipients":[{"phone":"05321234567","name":"Ayşe"}]}' # resposta {"ok":true,"data":{"campaign_id":152,"status":"queued","recipients":1,"credits":1}} # evento de entrega (webhook, assinado com HMAC) X-Buluthat-Event: sms.delivery {"event":"delivery","data":{"campaign_id":152,"status":"delivered"}}

O que há

Funcionalidades

Envio com um único pedido

ação send: um só número, lista ou textos diferentes por pessoa; os marcadores de posição são preenchidos a partir dos campos do destinatário.

Relatório de entrega

com status, consulte o estado de cada mensagem através do número de envio ou da sua própria referência (custom_ref).

Webhook assinado

Os eventos de entrega, SMS recebido e recusa chegam ao seu endereço assinados com X-Buluthat-Signature (HMAC-SHA256); em caso de falha, tenta-se de novo com recuo progressivo.

Consulta de crédito e de cabeçalho

com balance, o crédito SMS / OTP restante e as datas de validade; com headers, os seus cabeçalhos aprovados.

Envio agendado e cancelamento

com send_at, data futura até 90 dias; com cancel, as mensagens não enviadas são canceladas e o crédito é reposto.

Lista negra

com blacklist_add / blacklist_remove, sincronize a sua própria lista de recusas.

Endpoints OTP

gira o código de verificação com otp_send, otp_verify e otp_status sem manter uma tabela separada.

İYS e ritmo de envio

com is_commercial, a comunicação comercial passa pelo controlo İYS; com rate_per_minute, limita os envios por minuto.

Pedido

Comece a enviar SMS em 4 passos

Carrega os documentos pelo painel; nós acompanhamos a aprovação do cabeçalho.

O seu pedido

Preencha o formulário e escolha o pacote pretendido. Quando a conta for aberta, a palavra-passe do painel chega ao seu e-mail.

Carregue os documentos

Envie pelo painel os dados da empresa, a certidão fiscal, a identificação do representante, a ata de assinaturas e o termo de compromisso.

Aprovação do cabeçalho

O seu cabeçalho de SMS (3-11 caracteres) é aprovado em 1-3 dias úteis se os documentos estiverem completos.

Envie

Faça envios em massa a partir do painel com Excel ou agenda, ou ligue ao seu software com a API de SMS.

Candidate-se já Preços de SMS

FAQ

Sobre a API de SMS

Na página API de SMS da secção Programadores; com exemplos de pedido, resposta e códigos de erro.

Cria-a no painel, em SMS em Massa > API e Definições; o endereço do webhook também se indica nesse ecrã.

Um número repetido no mesmo pedido é enviado uma só vez; com a proteção contra duplicados ativa, o mesmo texto não é enviado duas vezes ao mesmo número no mesmo dia.

SMS

Mais fortes em conjunto

SMS em massa, código de verificação, SMS recebidos e API — com o seu cabeçalho aprovado.