Documentação da API

1. Obtendo um token:

Descrição: Após a execução desta consulta bem sucedida, você receberá um token. Subsequentemente, você pode usar este token para acessar o servidor e fazer solicitações adicionais.
Ponto: https://smsgateway24.com/getdata/gettoken
Método:: GET

Parâmetros da solicitação:

Variável	tipo	Descrição:
email	string	[Obrigatório] Your login in the system. Usually email
pass	string	[Obrigatório] Your password in the system

Resposta JSON-formatada::

Variável	tipo	Descrição:
token	string	Seu token é adquirido através do método de recuperação do token:
error	int	0 + 1 - indica se há um erro no processamento da solicitação
message	string	Mensagem de erro, vazia se tudo estiver em ordem.

Link para o exemplo Curl de código
Link para o exemplo de código Guzzle
Exemplo de resposta:
{"error":0,"message":"OK","token":"abbde3e31e9d026c02f41119fc551111e"}
or
{"error":1,"message":"Login or password incorrect"}

2. Enviar um SMS usando TOKEN:

Descrição: Gera mensagens SMS no servidor a serem enviadas coletivamente em um único lote. Habilita a criação de múltiplas mensagens SMS simultaneamente através de uma única solicitação.
Ponto: https://smsgateway24.com/getdata/addsms
Método:: GET, POST ( Usar %2B em vez do sinal de mais '+' na requisição GET )

Parâmetros da solicitação:

Variável	tipo	Descrição:
token	string	[Obrigatório] Seu token foi adquirido através do método de recuperação de token.
sendto	string	[Obrigatório]Número de telefone do assinante. Todos os caracteres são permitidos. Por exemplo: +4915752982212, +4917642111111, +1 17642031984. Alternativamente, vários números podem ser especificados por vírgulas
body	string	[Obrigatório] Corpo da mensagem
device_id	string	[Obrigatório] ID do dispositivo
timetosend	string YYYY-MM-DD or YYYY-MM-DD HH:MM:SS	[opcional] Tempo designado para enviar uma mensagem. Por exemplo, 2025-10-26 19:31:34
sim	int, default = 0	[opcional] SIM slot # 0 or 1
customerid	int	[opcional] Número de ID do seu cliente. Campo opcional.
urgent	int	[opcional] SMS marcado como urgente. Este campo é opcional. O SMS será enviado com prioridade, e pode ser benéfico ao enviar senhas de uso único (OTPs).

Resposta JSON-formatada::

Variável	tipo	Descrição:
token	string	Seu token é adquirido através do método de recuperação do token:
error	int	0 + 1 - indica se há um erro no processamento da solicitação
message	string	Mensagem de erro, vazia se tudo estiver em ordem.

Link para o exemplo Curl de código
Link para o exemplo de código Guzzle
Exemplo de resposta:

  {
    "error": 0,
    "sms_id": 62807347,
    "message": "Sms has been saved successfully"}

2.1 Enviar SMS único usando login e senha:

Descrição: Gera mensagens SMS no servidor a serem enviadas coletivamente em um único lote. Habilita a criação de múltiplas mensagens SMS simultaneamente através de uma única solicitação.
Ponto: https://smsgateway24.com/getdata/smstosend
Método:: GET, POST ( Usar %2B em vez do sinal de mais '+' na requisição GET )

Parâmetros da solicitação:

Variável	tipo	Descrição:
email	string	[Obrigatório] Seu e-mail
pass	string	[Obrigatório] Sua senha
sendto	string	[Obrigatório]Número de telefone do assinante. Todos os caracteres são permitidos. Por exemplo: +4915752982212, +4917642111111, +1 17642031984. Alternativamente, vários números podem ser especificados por vírgulas
body	string	[Obrigatório] Corpo da mensagem
device_id	string	[Obrigatório] ID do dispositivo
timetosend	string YYYY-MM-DD or YYYY-MM-DD HH:MM:SS	[opcional] Tempo designado para enviar uma mensagem. Por exemplo, 2025-10-26 19:31:34
sim	int, default = 0	[opcional] SIM slot # 0 or 1
customerid	int	[opcional] Número de ID do seu cliente. Campo opcional.
urgent	int	[opcional] SMS marcado como urgente. Este campo é opcional. O SMS será enviado com prioridade, e pode ser benéfico ao enviar senhas de uso único (OTPs).

Resposta JSON-formatada::

Variável	tipo	Descrição:
token	string	Seu token é adquirido através do método de recuperação do token:
error	int	0 + 1 - indica se há um erro no processamento da solicitação
message	string	Mensagem de erro, vazia se tudo estiver em ordem.

Link para o exemplo Curl de código
Link para o exemplo de código Guzzle
Exemplo de resposta:

  {
    "error": 0,
    "sms_id": 62807347,
    "message": "Sms has been saved successfully"}

3. Enviando SMS em massa usando JSON

Descrição: Cria SMS no servidor para enviar. Depois disso, o telefone com o aplicativo Smsgateway24 chama o servidor e toma o SMS e envia-o a partir do cartão SIM Baixar o aplicativo no link
Ponto: https://smsgateway24.com/getdata/addalotofsms
Método:: GET, POST

Parâmetros da solicitação:

Variável	tipo	Descrição:
datajson	string	[Obrigatório] {"token":"df427bfcf113c9a21c67718035076b5b","smsdata":[{"sendto":"015752982212","body":"Test message","sim":1,"timetosend":"2019-07-01 23:50:00","device_id":260},{"sendto":"+4915752982212","body":"Test message 2","sim":1,"timetosend":"2019-07-01 23:50:00","device_id":260,"urgent":1}]}

Resposta JSON-formatada::

Variável	tipo	Descrição:
error	int	0 + 1 - indica se há um erro no processamento da solicitação
message	string	Mensagem de erro, vazia se tudo estiver em ordem.

Link para o exemplo Curl de código
Link para o exemplo de código Guzzle
Request example:

{
   "token":"df427bfcf113c9a21c6771803501",
   "smsdata":[
        {
            "sendto":"015752982212",
            "body":"Your password is 12345",
            "sim":1,
            "timetosend":"2019-07-01 23:50:00",
            "device_id":260,
            "customerid":122,
            "urgent":1
        },
        {
            "sendto":"015752982212",
            "body":"Regular SMS. Not urgnet",
            "sim":1,
            "timetosend":"2019-07-01 23:50:00",
            "device_id":260,
            "customerid":122,
            "urgent":0
        }
    ]
}

4. Receber todos os SMS (incluindo SMS recebidos):

Descrição:: Este pedido permite que você recupere todas as mensagens associadas à sua conta, incluindo mensagens recebidas por SMS dos clientes. Todas as variáveis de entrada são obrigatórias neste método, e mensagens SMS podem variar em status.
Endpoint: https://smsgateway24.com/getdata/getallsms
Método: GET, POST (Usar %2B em vez do sinal de mais "+" na requisição GET)

Parâmetros da solicitação:

Variável	tipo	Descrição:
token	string	[Obrigatório] Seu token foi adquirido através do método de recuperação de token.
device_id	string	[opcional] ID do dispositivo
status	int	[opcional] 1 - Pendente por SMS 2 - SMS usado pelo telefone 3 - Enfileirado para envio. Certainly, it would have been more logical to place the status "queued for sending" before "SMS taken by phone," but for backward compatibility, the statuses are in the following order: 1, 3, 2." 5 - SMS de entrada 6 - SMS enviado por telefone 7 - O SMS foi entregue 8 - O SMS NÃO foi entregue 9 - O SMS não foi enviado - Falha genérica. (Leia o que fazer com esse erro Aqui) Outros erros menos comuns: 10 - SMS não enviado - No Service 11 - SMS não enviado - Null PDU 12 - SMS não enviado - Radio Off 100, 101 - SMS não enviado - NOT ALLOWED. (As permissões para o envio de SMS no aplicativo não foram concedidas)
begindate	string YYYY-MM-DD or YYYY-MM-DD HH:MM:SS	[opcional] Begin Date Time
enddate	string YYYY-MM-DD or YYYY-MM-DD HH:MM:SS	[opcional] End Date Time
sim	int	[opcional] SIM slot # 0 or 1
customerid	int	[opcional] Número de ID do seu cliente. Campo opcional
onlycount	int	[opcional] 0 \| 1 contador apenas
phone	string	[opcional] 0 \| 1 Filtro de números de telefone
orderbydesc	int	[opcional] 0 \| 1 Order by any field
timezone	int	[opcional] Especifique o seu fuso horário local, como configurá-lo para a Austrália/Sydney, por exemplo.

Resposta JSON-formatada::

Variável	tipo	Descrição:
token	string	Seu token é adquirido através do método de recuperação do token:
error	int	0 + 1 - indica se há um erro no processamento da solicitação
message	string	Mensagem de erro, vazio se tudo estiver em ordem
count	int	SMS amount
smss	int	JSON object

Link para o exemplo Curl de código
Link para o exemplo de código Guzzle
Exemplo de resposta ... :


            {
    "smss": {
        "62050971": {
            "id": 62050971,
            "sendto": "+4912312312332",
            "body": "Hello! Thank you for Order! ",
            "customerid": null,
            "status": 2,
            "statustitle": "sending",
            "deviceid": 11231,
            "urgent": null,
            "created": {
                "date": "2023-11-02 22:44:43.000000",
                "timezone_type": 3,
                "timezone": "Europe/Paris"
            },
            "senttime": null,
            "timetosend": null,
            "paketid": null,
            "pakettitle": null,
            "paketbody": null
        },
        "62051117": {
            "id": 62051117,
            "sendto": "+4912312312332",
            "body": "Hello! Thank you for Order! ",
            "customerid": null,
            "status": 7,
            "statustitle": "delivered",
            "deviceid": 11231,
            "urgent": null,
            "created": {
                "date": "2023-11-02 22:46:09.000000",
                "timezone_type": 3,
                "timezone": "Europe/Paris"
            },
            "senttime": null,
            "timetosend": null,
            "paketid": null,
            "pakettitle": null,
            "paketbody": null
        }
            }
            }

5. Adicionar uma nova lista de contatos

Descrição: A tag é necessária para gerar uma newsletter direcionada a um grupo de números. Por exemplo, use a tag Empregados
Ponto: https://smsgateway24.com/getdata/savetag
Método:: GET, POST

Parâmetros da solicitação:

Variável	tipo	Descrição:
token	string	[Obrigatório] Seu token foi adquirido através do método de recuperação de token.
title	string	[Obrigatório] Nome da Tag

Resposta JSON-formatada::

Variável	tipo	Descrição:
tag_id	int	Tag ID
error	int	0 + 1 - indica se há um erro no processamento da solicitação
message	string	Mensagem de erro, vazia se tudo estiver em ordem.

Link para o exemplo Curl de código
Link para o exemplo de código Guzzle
Exemplo de resposta:

{
    "error": 0,
    "tag_id": 8303,
    "message": "OK"
}

6. Adicionar contatos na lista de contatos:

Descrição: Adicione contatos para qualquer tag. Por exemplo, para a tag * Colaboradores * seus colegas vão perfeitamente se adequar.
Ponto: https://smsgateway24.com/getdata/savecontact
Método:: GET, POST

Parâmetros da solicitação:

Variável	tipo	Descrição:
token	string	[Obrigatório] Seu token foi adquirido através do método de recuperação de token.
phone	string	[Obrigatório] phone number
ctag_id	int	[Obrigatório] Tag ID
fullname	string	[Obrigatório] Nome do seu cliente

Resposta JSON-formatada::

Variável	tipo	Descrição:
contact_id	int	Contact Id
error	int	0 + 1 - indica se há um erro no processamento da solicitação
message	string	Mensagem de erro, vazia se tudo estiver em ordem.

Link para o exemplo Curl de código
Link para o exemplo de código Guzzle
Exemplo de resposta ... :
{"error":0,"contact_id":15954765,"message":"ok"}

7. Criar boletim informativo

Descrição:Depois de criar a etiqueta, você pode fazer a correspondência nos telefones de tag.
Ponto: https://smsgateway24.com/getdata/savepaket
Método:: GET, POST

Parâmetros da solicitação:

Variável	tipo	Descrição:
token	string	[Obrigatório] Seu token foi adquirido através do método de recuperação de token.
title	string	[Obrigatório] Título da Newsletter
device_id	string	[Obrigatório] ID do dispositivo
body	string	[Obrigatório] Corpo da mensagem alvo
tags	string	[Obrigatório] ID da tag. Pode ser várias, separadas por vírgulas. Por exemplo: 12,13,14
sim	int, default = 0	[Obrigatório]Número de SIM no telefone: 0 or 1
time_to_send	int, default = 0	[Obrigatório]Date time when Newsletter should be sent. Do not forget tap start on device. DD.MM.YYYY H:i:s

Resposta JSON-formatada::

Variável	tipo	Descrição:
contact_id	int	Id do Contato
error	int	0 + 1 - indica se há um erro no processamento da solicitação
message	string	Mensagem de erro, vazia se tudo estiver em ordem.
paket_id	int	Package ID

Link para o exemplo Curl de código
Link para o exemplo de código Guzzle
Exemplo de resposta ... :
{"error":0,"message":"OK","token":"abbde3e31e9d026c02f4f49fc551111e"}
or
{"error":1,"message":"Login or password incorrect"}

8. Obter lista de dispositivos

Descrição: Você pode descobrir tudo sobre seus dispositivos.
Ponto: https://smsgateway24.com/getdata/getalldevices
Método:: GET, POST

Parâmetros da solicitação:

Variável	tipo	Descrição:
token	string	[Obrigatório] Seu token foi adquirido através do método de recuperação de token.

Resposta JSON-formatada::

Variável	tipo	Descrição:
count	int	Número de dispositivos:
device	json	id - ID do dispositivo title - Nome do dispositivo created - Data de criação do dispositivo createdhumanformat - Data de criação do dispositivo em formato regular lastseen - A data em que o dispositivo foi visto pela última vez lastseenhumanformat - A data em que o dispositivo foi visto pela última vez serialnumber - Número de série do dispositivo siminfo - Informações sobre cartões SIM no JSON appversion - A versão do aplicativo instalado no dispositivo subscription - Há uma assinatura no dispositivo
message	string	Mensagem de erro, vazia se tudo estiver em ordem.

Link para o exemplo Curl de código
Link para o exemplo de código Guzzle
Exemplo de resposta:

    {
    "count": 2,
    "device": {
        "1576": {
            "id": 1576,
            "title": "AOSP_on_IA_Emulator",
            "number": null,
            "imei": "358240051111110",
            "created": {
                "date": "2020-03-28 20:10:29.000000",
                "timezone_type": 3,
                "timezone": "UTC"
            },
            "createdhumanformat": "28.03.2020 20:10:29",
            "lastseen": {
                "date": "2020-04-23 17:02:21.000000",
                "timezone_type": 3,
                "timezone": "UTC"
            },
            "lastseenhumanformat": "23.04.2020 17:02:21",
            "serialnumber": "EMULATOR30X0X5X0",
            "siminfo": [
                {
                    "Slot": "0",
                    "IccId": "89014103211118510720",
                    "Number": " 15555215554",
                    "Roaming": "0",
                    "CountryIso": "us",
                    "CarrierName": "Android (T-Mobile)"
                }
            ],
            "appversion": "12.1.21",
            "isappversionactual": false,
            "delaybetweeneachsms": null,
            "delaybetweenrequest": 1,
            "subscription": true
        },
        "1297": {
            "id": 1297,
            "title": "Android_SDK_built_for_x86",
            "number": null,
            "imei": "null",
            "created": {
                "date": "2020-01-20 14:01:05.000000",
                "timezone_type": 3,
                "timezone": "UTC"
            },
            "createdhumanformat": "20.01.2020 14:01:05",
            "lastseen": {
                "date": "2020-04-20 20:51:34.000000",
                "timezone_type": 3,
                "timezone": "UTC"
            },
            "lastseenhumanformat": "20.04.2020 20:51:34",
            "serialnumber": "unknown",
            "siminfo": [
                {
                    "Slot": "0",
                    "IccId": "8949226172233934327",
                    "Number": "+4915752982212",
                    "Roaming": "1",
                    "CountryIso": "de",
                    "CarrierName": "Drillisch (o2)"
                }
            ],
            "appversion": "12.1.21",
            "isappversionactual": false,
            "delaybetweeneachsms": 5,
            "delaybetweenrequest": 10,
            "subscription": false
        }
    }
}

9. Obter o Status de Entrega de um único SMS

Descrição: Você pode descobrir o status de entrega de cada SMS usando este método
Ponto: https://smsgateway24.com/getdata/getsmsstatus
Método:: GET, POST

Parâmetros da solicitação:

Variável	tipo	Descrição:
token	string	[Obrigatório] Seu token foi adquirido através do método de recuperação de token.
sms_id	int	[Obrigatório] Sms Id

Resposta JSON-formatada::

Variável	tipo	Descrição:
sms_id	int	SMS ID
status	int	SMS Status 1 - Pendente por SMS 2 - SMS usado pelo telefone 3 - Enfileirado para envio. Certainly, it would have been more logical to place the status "queued for sending" before "SMS taken by phone," but for backward compatibility, the statuses are in the following order: 1, 3, 2." 5 - SMS de entrada 6 - SMS enviado por telefone 7 - O SMS foi entregue 8 - O SMS NÃO foi entregue 9 - O SMS não foi enviado - Falha genérica. (Leia o que fazer com esse erro Aqui) Outros erros menos comuns: 10 - SMS não enviado - No Service 11 - SMS não enviado - Null PDU 12 - SMS não enviado - Radio Off 100, 101 - SMS não enviado - NOT ALLOWED. (As permissões para o envio de SMS no aplicativo não foram concedidas)
status_description	string	Nome do Status
error	int	0 \| 1 - ocorreu um erro ao processar o pedido
message	string	Mensagem de erro, vazia se tudo estiver em ordem.

Link para o exemplo Curl de código
Link para o exemplo de código Guzzle
Exemplo de resposta:
{"error":0,"message":"OK","token":"abbde3e31e9d026c02f4f49fc551111e"}
or
{"error":1,"message":"Login or password incorrect"}

Acesso rápido

Referência de API

SDKs e outras bibliotecas

Complementos

Documentação | SmsGateway24.com

1. Obtendo um token:

2. Enviar um SMS usando TOKEN:

2.1 Enviar SMS único usando login e senha:

3. Enviando SMS em massa usando JSON

4. Receber todos os SMS (incluindo SMS recebidos):

5. Adicionar uma nova lista de contatos

6. Adicionar contatos na lista de contatos:

7. Criar boletim informativo

8. Obter lista de dispositivos

9. Obter o Status de Entrega de um único SMS

Acesso rápido

Documentação da api

Referência de API

SDKs e outras bibliotecas

Complementos

Documentação | SmsGateway24.com

1. Obtendo um token:

2. Enviar um SMS usando TOKEN:

2.1 Enviar SMS único usando login e senha:

3. Enviando SMS em massa usando JSON

4. Receber todos os SMS (incluindo SMS recebidos):

5. Adicionar uma nova lista de contatos

6. Adicionar contatos na lista de contatos:

7. Criar boletim informativo

8. Obter lista de dispositivos

9. Obter o Status de Entrega de um único SMS