Pular para o conteúdo principal

Configuração

Antes de enviar mensagens SMS, você precisa conectar o módulo a um provedor de gateway SMS e configurar suas definições de remetente. Esta página explica todas as opções de configuração.

Acessando as Configurações do Módulo​

  1. Faça login no painel de administração do Concord CRM
  2. Navegue até Custom SMS -> Settings na barra lateral
  3. A página de configurações exibe todas as opções organizadas por seção

Configuração do Gateway SMS​

O módulo Custom SMS requer um gateway SMS externo para entregar mensagens. Configure as credenciais do seu provedor na seção de gateway.

Gateways Suportados​

ProvedorCredenciais Necessárias
TwilioAccount SID, Auth Token, Número de Telefone do Remetente
VonageAPI Key, API Secret, Número de Telefone do Remetente
OutroAPI Key/Token, Sender ID (varia por provedor)

Conectando Seu Gateway​

  1. Vá até Custom SMS -> Settings -> Gateway
  2. Selecione seu provedor SMS no menu suspenso
  3. Insira as credenciais necessárias para o provedor escolhido
  4. Defina o Número de Telefone do Remetente ou Sender ID
  5. Clique em Save
  6. Use o botão Send Test SMS para verificar a conexão
dica

Insira números de telefone no formato E.164 (ex.: +5511999999999). A maioria das falhas de entrega é causada por números de remetente ou destinatário formatados incorretamente.

SMS de Teste​

Após salvar as credenciais do gateway, sempre envie uma mensagem de teste:

  1. Clique em Send Test SMS
  2. Insira um número de telefone ao qual você tem acesso
  3. Clique em Send
  4. Verifique se a mensagem chega ao seu telefone

Se o teste falhar, verifique suas credenciais e certifique-se de que sua conta no gateway está ativa com saldo suficiente.

Configurações do Remetente​

Sender ID / Número de Telefone​

A identidade do remetente que os destinatários veem quando recebem sua mensagem. Dependendo do seu provedor e país:

  • Número de Telefone -- um número comprado do seu provedor de gateway (mais comum)
  • Sender ID Alfanumérico -- um rótulo de texto personalizado (ex.: "MeuCRM") suportado em algumas regiões
aviso

Sender IDs alfanuméricos não são suportados em todos os países. Consulte a documentação do seu provedor de gateway para disponibilidade regional. Os destinatários não podem responder a mensagens enviadas de IDs alfanuméricos.

Código de País Padrão​

Defina um código de país padrão para não precisar incluí-lo toda vez. O módulo adicionará automaticamente o código de país aos números que não possuem um.

  1. Vá até Custom SMS -> Settings -> General
  2. Defina o Código de País Padrão (ex.: +55 para Brasil, +1 para EUA)
  3. Clique em Save

Configuração de Agendamento​

O módulo Custom SMS suporta agendamento de mensagens para entrega futura. Para que as mensagens agendadas sejam enviadas no horário, certifique-se do seguinte:

Configuração do Cron Job​

As mensagens SMS agendadas são despachadas pelo cron job do Concord CRM. Verifique se o cron está configurado e em execução:

* * * * * php /path/to/concord/artisan schedule:run >> /dev/null 2>&1
informação

Se o cron job não estiver em execução, as mensagens agendadas permanecerão na fila e não serão entregues até que o cron seja executado.

Fuso Horário​

O sistema de agendamento utiliza o fuso horário configurado nas configurações do Concord CRM. Para verificar ou atualizar:

  1. Vá até Settings -> General no Concord CRM
  2. Verifique a configuração de Timezone
  3. Certifique-se de que corresponde ao seu fuso horário local para que as mensagens agendadas sejam enviadas no horário esperado

Integração com Ações do CRM​

O módulo pode ser acionado a partir de diversas ações do CRM. Configure quais ações exibem a opção de SMS:

  1. Vá até Custom SMS -> Settings -> Integrations
  2. Ative ou desative o SMS para cada tipo de ação do CRM:
    • Calls -- enviar SMS após registrar uma ligação
    • Tasks -- enviar SMS relacionado a atualizações de tarefas
    • Emails -- complementar comunicação por e-mail com SMS
    • Meetings -- enviar confirmações ou lembretes de reuniões
    • Deadlines -- notificar contatos sobre prazos próximos
  3. Clique em Save

Quando um tipo de ação está habilitado, um botão Send SMS aparecerá no registro correspondente do CRM.

Rastreamento de Status de Entrega​

O módulo rastreia automaticamente o status de entrega do seu provedor de gateway. As atualizações de status são recebidas via webhooks:

StatusSignificado
QueuedMensagem aceita pelo gateway, aguardando entrega
SentMensagem despachada para a rede da operadora
DeliveredMensagem confirmada como entregue ao destinatário
FailedEntrega falhou (número inválido, problema na operadora)
informação

Alguns provedores de gateway suportam recibos de entrega (DLR) para rastreamento mais detalhado. Ative o DLR no painel do seu provedor para as atualizações de status mais precisas.

Solução de Problemas de Configuração​

ProblemaSolução
SMS de teste não chegaVerifique as credenciais; confira o saldo da conta do gateway
Erro "Invalid sender"Certifique-se de que o número do remetente está verificado/comprado no gateway
Mensagens agendadas não enviandoConfirme que o cron job está ativo e rodando a cada minuto
Status de entrega não atualizandoVerifique a configuração do webhook no painel do seu provedor
Código de país não aplicadoVerifique se o código de país padrão está salvo nas configurações Gerais