# APIs de SMS (SyBox)

Onde: Definições > Mensagens > APIs de SMS

Para que serve: Adicione provedores de SMS como canal de backup. Se você definir um país para um gateway, ele se tornará o gateway preferencial para contatos daquele país.

Quem pode acessar: Usuários com a permissão "Gerenciar gateways SMS".

### Como adicionar um gateway de SMS

1. Clique em "Adicionar API de SMS".
   ![Settings, SMS APIs: a connected SMS gateway and the "Add SMS API" button](https://www.sybox.io/res/sybox/help/pt/add-an-sms-gateway-1.webp?v=46a033f5)
2. Provedor: Escolha MessageBird, SMS Misr, Texto ou Twilio. O formulário exibe apenas os campos necessários para o provedor selecionado.
   ![The new SMS gateway window: the provider first, then the country, keys and sender](https://www.sybox.io/res/sybox/help/pt/add-an-sms-gateway-2.webp?v=80047877)
3. Nome de exibição: Um nome para sua própria referência.
4. País: Um código de duas letras, por exemplo BR. Deixe em branco para usar o gateway para todos os países.
5. Preencha os dados do provedor:
   - MessageBird: Sender ID (o nome ou número que o destinatário vê) e API Key.
   - SMS Misr: Sender ID, Usuário, Senha e Sender Token. O Sender Token é o valor fornecido pela SMS Misr para o seu Sender ID.
   - Texto: Apenas a API Key.
   - Twilio: Sender ID (seu número De ou Messaging Service), Account SID e Auth Token.
6. Ativo: Deixe ativado para usar o gateway.
7. Clique em Salvar. Se faltar algum campo obrigatório, você verá "Dados incompletos".

### Como enviar um SMS de teste

1. Clique em "Enviar SMS de teste" (o ícone de envio) no card do gateway.
   ![To send a test SMS: "Send test SMS" marked on the screen in SyBox](https://www.sybox.io/res/sybox/help/pt/send-a-test-sms-1.webp?v=88452923)
2. Insira um número de telefone no formato internacional, por exemplo +5511…, e edite a mensagem se desejar.
3. Clique em Salvar. Você verá "SMS de teste enviado." Se o provedor recusar, o erro será exibido.

Outras ações

- Editar: Altere qualquer campo. Deixe o campo de senha ou chave em branco para manter a atual.
- Ativar / Desativar: Ative ou desative o gateway.
- Excluir: "Excluir este gateway de SMS permanentemente?"
- Um card exibindo "Token ausente" não possui chave salva. Edite-o e adicione a chave.

Source: https://www.sybox.io/pt/help/sms-apis