Configurar canal SMS

Um canal SMS permite que sua equipe entre em contato com clientes diretamente em seus celulares — e vice-versa. As mensagens SMS recebidas aparecem no Virtual-Call UC Client, onde os agentes podem respondê-las. Este artigo descreve como configurar um canal SMS no Cloud PABX.

Pré-requisitos

• Provedor SMS: Você precisa de uma conta em um dos provedores de serviço SMS suportados (veja tabela abaixo) com um número de telefone habilitado para SMS.
• Nome de domínio: O nome de domínio do seu Cloud PABX não deve conter caracteres de sublinhado (_), pois isso pode causar falhas na autenticação do webhook.
• Certificado de domínio: Se o seu PABX utiliza um domínio personalizado (não o domínio padrão do provedor), um certificado de domínio válido deve estar instalado.

Provedores SMS suportados

A tabela a seguir mostra os provedores suportados e as credenciais de autenticação necessárias para cada um:

Se o seu provedor SMS não estiver na lista, ele pode ser integrado via API de SMS. Entre em contato com o suporte Virtual-Call para mais informações.

Configuração

A configuração de um canal SMS envolve duas etapas principais:

1. Criar e configurar o canal SMS no PABX
2. Configurar o webhook no seu provedor SMS

Etapa 1: Criar o canal SMS no PABX

1. Faça login no portal administrativo do Cloud PABX.
2. Acesse Mensagens > Canal.
3. Clique em Adicionar e selecione SMS.
4. Configure a aba Autenticação:
   • Nome: Um nome descritivo (ex.: “SMS Suporte” ou “SMS Vendas”).
   • ITSP: Selecione seu provedor de serviço SMS na lista.
   • Credenciais: Insira as credenciais de autenticação do seu provedor (veja tabela acima).
   • Webhook URL: Gerada automaticamente. Copie-a — você vai precisar na Etapa 2.

5. Configure a aba Configurações de Mensagens:
   • Taxa de envio de mensagens: Número máximo de mensagens por segundo. Se este valor exceder o limite do seu provedor SMS, podem ocorrer falhas na entrega. Verifique o limite com seu provedor.
   • Fechar sessão automaticamente: Ative esta opção e defina um tempo limite em dias para fechar automaticamente sessões inativas.
   • Permitir a criação de sessões ativas duplicadas: Se um novo agente pode criar uma sessão quando já existe uma sessão ativa com o mesmo contato.
6. Configure a seção Número:
   • Clique em Adicionar.
   • Número: Insira o número de telefone no formato E.164 (ex.: +5511912345678) ou um ID alfanumérico de remetente.
   • Destino para mensagens de entrada: Escolha para onde as SMS recebidas são encaminhadas:
     • Extensão: As mensagens vão diretamente para um ramal específico.
     • Fila de mensagens: As mensagens vão para uma fila onde vários agentes podem atendê-las.
   • Extensões permitidas para criar sessões de mensagens: Selecione quais ramais podem enviar mensagens por este canal.
7. Clique em Salvar.

Etapa 2: Configurar o Webhook no provedor SMS

Para que o PABX possa receber SMS, você precisa inserir a Webhook URL na configuração do seu provedor SMS:

1. Faça login no portal do seu provedor SMS.
2. Localize as configurações de webhook ou callback para o seu número SMS.
3. Insira a Webhook URL que você copiou do PABX na Etapa 1.
4. Salve as configurações.

Os passos exatos variam conforme o provedor. Consulte a documentação do seu provedor SMS para detalhes.

Resultado

Após a configuração bem-sucedida, o canal SMS aparece na lista de canais em Mensagens > Canal com um ícone de status verde. O PABX registra automaticamente o número de mensagens enviadas e recebidas.

Notas importantes

• Segmentação de SMS: Mensagens de texto com mais de 160 caracteres são automaticamente divididas em vários segmentos. Isso pode aumentar a quantidade real de mensagens cobradas pelo seu provedor.
• Tamanho de arquivo MMS: Mensagens multimídia (MMS) são limitadas a 100 MB. Os arquivos são retidos por 72 horas.
• Registro 10DLC (EUA): Para enviar SMS para números dos EUA, seu número 10DLC (código longo de 10 dígitos) deve estar registrado para mensagens A2P. Caso contrário, as mensagens serão bloqueadas. Entre em contato com seu provedor SMS para o registro.
• Acesso IP para MMS: Se você configurou regras de segurança de acesso por IP, certifique-se de que o acesso do país do seu provedor SMS esteja permitido — caso contrário, os arquivos MMS não poderão ser entregues.