As respostas chegam ao número de celular que seu contato já conhece.
SMSMobileAPI / API
Recebidos SMS API · Seu celular continua sendo a caixa de entrada
Transforme cada SMS recebido no seu celular em dados utilizáveis pela aplicação.
Seu contato envia um SMS normal para o número de celular existente. A mensagem chega primeiro ao telefone conectado, então o SMSMobileAPI sincroniza com segurança os dados suportados para que sua aplicação possa recuperar, classificar e processar a resposta.
Nenhum número virtual substitui seu telefone: seu celular, o SIM e o número atual permanecem no centro da comunicação.
AUm contato envia um SMS
Você pode me ligar de volta?
+1 555 012 9841
Você pode me ligar de volta?
/getsms/200sms.received
number+15550129841
deviceCelular de vendas
statusPronto
Seu software o utiliza
Recupere o remetente, a mensagem, o celular receptor, o carimbo de data/hora, o GUID e o alias opcional.
Centralize as respostas preservando qual telefone conectado recebeu cada SMS.
A explicação simples
O API não substitui seu telefone. Ele torna os SMS recebidos utilizáveis.
O SMSMobileAPI adiciona uma camada de software segura em torno da caixa de entrada do celular real. Isso dá ao seu CRM, plataforma de suporte ou aplicação interna acesso aos dados elegíveis de mensagens recebidas sem mudar o número usado pelos seus contatos.
Um contato envia um SMS
O contato escreve para o número real associado ao seu SIM.
Seu celular recebe a mensagem
O SMS chega pela sua operadora móvel ao telefone conectado.
O aplicativo sincroniza-o.
Com a permissão necessária e acesso em segundo plano, o app oficial envia com segurança os dados de mensagens suportados para sua conta.
Seu software o utiliza
Recupere-o com o REST API, receba um evento Webhook V2 ou exiba-o em uma integração compatível.
Uma resposta que sua aplicação pode usar
Uma requisição retorna a mensagem e o contexto necessários para processá-la.
Use GET /getsms/ para listar SMS recebidos sincronizados. Filtre por celular receptor, solicite apenas mensagens não lidas ou recupere mensagens após um carimbo Unix.
- number
- O remetente em formato internacional quando disponível.
- message
- O texto SMS sincronizado do celular conectado.
- sIdentifiantPhone
- O celular conectado que recebeu o SMS.
- timestamp_unix
- O horário da mensagem, pronto para ordenação e sincronização incremental.
- guid
- Uma referência estável da mensagem para controle de leitura e operações de acompanhamento.
- alias
- Um rótulo opcional de contato ou de aplicação.
{
"result": {
"error": "",
"sms": [{
"sIdentifiantPhone": "508b004b4aadacc4",
"timestamp_unix": 1774041814,
"message": "Can you call me back?",
"number": "+15550129841",
"guid": "6BFD7DC7-3492-422D-8D02-4AF4E614F122",
"alias": "Alex Morgan"
}]
}
}Escolha o padrão de entrega adequado
Busque mensagens por API — ou reaja imediatamente com Webhook V2.
Ambos os métodos utilizam os mesmos dados do telemóvel conectado. Escolha conforme o funcionamento da sua aplicação, ou combine-os para reações rápidas e recuperação fiável.
A sua aplicação solicita mensagens quando estiver pronta.
- Crie uma caixa de entrada ou uma sincronização agendada
- Filtre por telemóvel, hora ou por mensagens não lidas
- Recupere mensagens após uma interrupção
SMSMobileAPI envia um evento sms.received para o seu destino HTTPS.
- Reaja sem um ciclo de polling
- Use entrega durável e reenvios automáticos
- Inicie um fluxo de trabalho assim que o evento estiver disponível
MAIS DO QUE UMA SIMPLES LISTA DE MENSAGENS
Construa um fluxo completo de SMS recebidos.
/getsms/Liste SMS recebidos
Use filtros por telemóvel, carimbo de data/hora e mensagens não lidas para recuperar apenas o que a sua aplicação precisa.
/getsms/set-read/Marcar como processado
Atualize o estado de leitura API do SMSMobileAPI depois que a sua aplicação processar uma mensagem.
/getsms/update/Anexar um alias
Associe um nome de contacto ou rótulo da aplicação a uma mensagem recebida.
/conversation/sms/list/Crie conversas
Agrupe mensagens recebidas e enviadas por número de telefone para uma cronologia de suporte ou CRM.
Assinalar uma mensagem como lida através do API não altera o seu estado de leitura na aplicação de mensagens do telemóvel.
O QUE PODE CONSTRUIR?
Desde uma resposta até um processo de negócio completo.
Crie uma caixa de entrada SMS partilhada
Encaminhe respostas de vários telemóveis autorizados para uma única visão de suporte, preservando o telemóvel receptor.
Complete a cronologia de contactos
Adicione respostas recebidas a um registo de cliente juntamente com SMS enviados e actividade de chamadas suportadas.
Interprete confirmações automaticamente
Detecte confirmações, cancelamentos ou pedidos de reagendamento e atualize o próximo passo.
Escale mensagens importantes
Notifique a pessoa certa, chame um API ou inicie uma automação Workflow Studio quando as condições corresponderem.
Do zero à primeira resposta API
Receba o seu primeiro SMS através do API em quatro etapas controladas.
- 1
Instale e emparelhe o telemóvel
Instale a aplicação SMSMobileAPI oficial mais recente e conecte o telemóvel compatível à sua conta.
- 2
Ative o acesso a SMS recebidos
Na aplicação móvel, autorize a sincronização de SMS recebidos e a operação em segundo plano necessária para o seu fluxo de trabalho.
- 3
Envie uma mensagem de teste única
Envie um SMS a partir de outro número para o telemóvel conectado e verifique‑o no registo do painel de SMS recebidos.
- 4
Chame o endpoint de forma segura
Mantenha a chave API no seu servidor, chame /getsms/ e armazene o GUID para que a sua aplicação possa evitar processamento duplicado.
FAQ — SMS recebidos no API
Perguntas que desenvolvedores e equipes operacionais fazem primeiro.
O API recebe o SMS em vez do meu celular?
Não. Seu dispositivo móvel e SIM compatíveis conectados recebem o SMS primeiro. O SMSMobileAPI então sincroniza os dados de mensagem suportados para que possam ser recuperados pelo seu software.
Vários dispositivos móveis podem alimentar a mesma aplicação?
Sim. Vários dispositivos móveis autorizados podem ser conectados a uma conta, e o identificador do dispositivo receptor permite que sua aplicação preserve a origem de cada mensagem.
Devo usar consulta periódica (polling) ou Webhook V2?
Use GET /getsms/ quando sua aplicação controla a agenda de recuperação ou precisa de mecanismos de recuperação. Use o evento Webhook V2 do sms.received quando quiser que um destino HTTPS reaja assim que o evento estiver disponível. Muitos sistemas de produção combinam ambos.
Como evito processar a mesma mensagem duas vezes?
Armazene o GUID da mensagem em sua aplicação e torne o processamento idempotente. Após o processamento bem‑sucedido, você também pode atualizar o estado de leitura API do SMSMobileAPI.
Marcar uma mensagem como lida altera a caixa de entrada do telefone?
Não. O endpoint altera o estado de leitura do lado API usado pelos fluxos do SMSMobileAPI; ele não marca a mensagem como lida dentro do aplicativo de mensagens do telefone.
Posso responder a partir da minha aplicação?
Sim. Sua aplicação pode chamar o endpoint de envio do SMS para que um dispositivo móvel conectado selecionado envie a resposta através do seu SIM e número móvel.
Faça com que seu software capture cada resposta útil recebida pelo seu celular.
Conecte um telefone, autorize a sincronização received-SMS e teste toda a jornada antes de estendê-la ao seu CRM, plataforma de suporte ou automação.
