---
title: "Como integrar envio de SMS no meu app com uma API?"
description: "Como integrar envio de SMS no seu app via API: credenciais, formato do número, codificação, webhooks de entrega, novas tentativas e checagens antes do go-live."
canonical: "https://omnichannels.ai/pt/answers/integrate-sms-api/"
language: "pt"
updated: "2026-10-10"
publisher: "BroadNet Technologies"
brand: "OmniChannels.ai"
---

# Como integrar envio de SMS no meu app com uma API?

Canonical: https://omnichannels.ai/pt/answers/integrate-sms-api/
Language: pt
Publisher: OmniChannels.ai by BroadNet Technologies

**Resposta curta:** Para integrar envio de SMS em um app, chame a API de SMS do fornecedor pelo seu backend, com token de acesso, número do destinatário em formato internacional, ID de remetente (Sender ID) aprovado e o texto. Guarde o ID de mensagem retornado, receba os status de entrega em um webhook e trate erros, novas tentativas e limites de taxa antes do go-live.

## Etapas da integração

1. Obtenha credenciais de teste e cadastre os números de teste que vão receber as mensagens.
2. Guarde o token da API em um gerenciador de segredos ou variável de ambiente no servidor, nunca em app mobile ou código de navegador.
3. Armazene os números no formato E.164 e converta-os para o formato que a API espera.
4. Escolha a codificação: texto GSM-7 ou Unicode para árabe, emoji e outras escritas.
5. Envie a mensagem e salve o ID retornado junto com o seu próprio registro.
6. Configure um webhook para receber os status de entrega.
7. Implemente novas tentativas com backoff para respostas 429 e 5xx e registre IDs de remetente em cada país que exigir.

## Erros a evitar

- Chamar a API pelo app cliente, o que expõe o token para qualquer pessoa.
- Enviar números com sinal de mais, espaços ou zero nacional à esquerda quando a API espera só dígitos.
- Deixar uma única aspa curva ou emoji mudar a mensagem inteira para Unicode, o que reduz os caracteres por segmento.
- Repetir o envio às cegas após um timeout. Se a API não tiver chave de idempotência, registre cada envio antes e consulte o status antes de reenviar.
- Ignorar respostas 429 em vez de aguardar o tempo do header Retry-After.

## Exemplo: uma requisição de SMS

Na OmniChannels.ai, você envia um SMS com POST https://api.broadnet.me/sms/sendSms, um header Authorization: Bearer e um corpo JSON. Uma chamada bem-sucedida retorna 200 com o ID da mensagem em texto simples. O acesso de teste é liberado após uma breve solicitação e envia para os seus próprios números verificados; não há cadastro instantâneo em autoatendimento.

| Campo | Exemplo | Observação |
|---|---|---|
| senderId | OmniDemo | Seu ID de remetente aprovado |
| destinationNumber | 447700900123 | Código do país mais o número, só dígitos |
| message | Your code is 482913 | O texto |
| messageType | TEXT | TEXT para GSM-7, UNICODE para árabe e emoji |

## Fontes oficiais

- [RFC 9110: HTTP Semantics (IETF)](https://datatracker.ietf.org/doc/html/rfc9110)
- [ITU-T Recommendation E.164 — The international public telecommunication numbering plan](https://www.itu.int/rec/T-REC-E.164)
- [3GPP TS 23.038 — Alphabets and language-specific information](https://portal.3gpp.org/desktopmodules/Specifications/SpecificationDetails.aspx?specificationId=745)

## Perguntas relacionadas

- https://omnichannels.ai/pt/answers/smpp-vs-http-api/
- https://omnichannels.ai/pt/answers/delivery-report-webhook/
- https://omnichannels.ai/pt/answers/why-sms-split-into-parts/
- https://omnichannels.ai/pt/answers/what-is-sender-id/
- https://omnichannels.ai/pt/answers/send-whatsapp-message-api/

Atualizado em: 2026-10-10