Configuração de SMS

O NextCRM envia e recebe SMS por meio do Twilio. Cada workspace conecta a sua própria conta Twilio, então as mensagens saem do seu número e os custos são cobrados pelo Twilio diretamente de você. Depois de configurado, qualquer pessoa da equipe pode enviar SMS a um lead pelo cartão ou pela tela de detalhes.

Observação: Apenas Administradores do workspace podem alterar as configurações de SMS. As outras funções, incluindo Gerentes de vendas, não veem a etapa SMS na Implantação. O seu plano precisa incluir o recurso SMS messaging para salvar as configurações e enviar mensagens.

Onde obter cada valor

Entre no Twilio Console em https://console.twilio.com/ e anote os valores abaixo. O ícone (i) ao lado de cada campo na etapa SMS mostra as mesmas informações.

Campo no NextCRM	Onde obter no Twilio	Link
Twilio Account SID	O ID da sua conta Twilio, começa com AC. Twilio Console > Account Dashboard, seção Account Info.	https://console.twilio.com/
Auth Token	A chave secreta da mesma conta. Twilio Console > Account Dashboard > Account Info: clique em Show ao lado de Auth Token.	https://console.twilio.com/
Número de Origem	Um número Twilio habilitado para SMS, no formato internacional, por exemplo +5511999999999. Twilio Console > Phone Numbers > Manage > Active numbers.	https://console.twilio.com/us1/develop/phone-numbers/manage/incoming
Messaging Service SID (opcional)	Alternativa ao Número de Origem, começa com MG. Twilio Console > Messaging > Services: abra o serviço e copie o SID.	https://console.twilio.com/us1/develop/sms/services
Test Account SID / Test Auth Token	Credenciais de teste gratuitas, que nunca enviam um SMS real. Twilio Console > Account > API keys & tokens, seção Test credentials.	https://console.twilio.com/us1/account/keys-credentials/api-keys
URL do webhook de entrada	Aparece no NextCRM depois de salvar. Cole-a no Twilio: Phone Numbers > Active numbers > seu número > Messaging configuration > A message comes in: Webhook, HTTP POST.	https://console.twilio.com/us1/develop/phone-numbers/manage/incoming

Ordem de configuração: crie ou abra a sua conta Twilio > copie o Account SID e o Auth Token e escolha um número ou um Messaging Service > cole-os no NextCRM e salve > cole a URL do webhook de entrada no Twilio > teste a conexão e envie um SMS de teste.

Você precisa de um Número de Origem ou de um Messaging Service SID. Para envios em produção, o Messaging Service é a opção recomendada.

Atenção: No modo de produção, o Auth Token é sempre obrigatório, porque o NextCRM o usa tanto para chamar o Twilio quanto para confirmar que os webhooks recebidos vêm mesmo do Twilio. Por isso o NextCRM não pede uma API Key do Twilio.

Conectar o Twilio passo a passo

1. Abra Implantação > SMS (abrir a etapa SMS). O cartão SMS e chamadas em Configurações abre a mesma etapa.
2. Ative Habilitar integração de SMS.
3. Em Ambiente do Twilio, escolha Produção (mensagens reais) ou Teste (mensagens simuladas, veja abaixo).
4. Preencha as Credenciais de produção: Twilio Account SID, Auth Token e Número de Origem e/ou Messaging Service SID.
5. Confira o Código de País Padrão (por exemplo +55). Ele é adicionado aos telefones que foram salvos sem código de país.
6. Clique em Salvar configurações de SMS.
7. Clique em Testar conexão. Se der certo, aparece "Conexão Twilio verificada." e o selo de status no topo muda para conectado.

No topo da página, o cartão Conecte o Twilio em três etapas acompanha o seu progresso: Informe suas credenciais do Twilio, Verifique a conexão e Ative o SMS. As etapas são marcadas a partir das configurações salvas e do último teste de conexão. O passo a passo com as instruções fica dentro deste cartão.

Se o Número de Origem não estiver no formato internacional, o campo mostra "Use o formato internacional com código do país, ex.: +5511912345678."

Os segredos são criptografados em repouso, mascarados após salvar e nunca mais exibidos. Deixe um campo de segredo em branco para manter o valor salvo.

URLs de webhook (receber respostas)

Depois de salvar, o NextCRM mostra dois endereços somente leitura, com botão de copiar:

• URL do webhook de entrada: o Twilio chama esse endereço quando um lead responde ao seu número.
• URL de callback de status: o Twilio informa por ele o status de entrega (enviado, entregue, falhou).

O NextCRM envia a URL de callback de status automaticamente junto com cada mensagem, então você não precisa cadastrá-la no Twilio. A URL de entrada você mesmo precisa configurar:

1. No Twilio Console, abra a configuração do seu número de telefone (ou, se você envia por um Messaging Service, as configurações de integração do serviço).
2. Na parte de mensagens, para mensagens recebidas ("A message comes in"), escolha Webhook, cole a URL do webhook de entrada e selecione HTTP POST.
3. Salve no Twilio.

As respostas recebidas são associadas ao lead com o mesmo número de telefone e aparecem no histórico de SMS desse lead. Se nenhum lead, ou mais de um, tiver esse número, a mensagem fica guardada como não atribuída, em vez de ir para o lead errado.

Modo de teste

Escolha Teste em Ambiente do Twilio para experimentar a configuração sem custo:

• Informe o Test Account SID e o Test Auth Token do Twilio.
• O NextCRM sempre envia as mensagens de teste a partir de +15005550006, o número mágico do Twilio para um envio de teste bem-sucedido, então não há remetente para informar.
• Mensagens de teste não são cobradas, não chegam a telefones reais, não acionam callbacks de status e não recebem respostas. Os leads mostram um aviso de que o modo de teste do Twilio está ativo.

Volte para Produção e clique em Salvar configurações de SMS quando quiser enviar mensagens reais.

Enviar uma mensagem de teste

Em Enviar SMS de teste, informe o seu próprio celular no formato internacional, ajuste o texto se quiser e clique em Enviar. Se o número não estiver no formato internacional, aparece "Use o formato internacional com código do país, ex.: +5511912345678." e Enviar fica desativado. O NextCRM confirma com "SMS de teste na fila." No modo de produção é um SMS real, e o Twilio cobra como qualquer outra mensagem.

Enviar SMS para um lead

• No cartão do lead, clique no botão de SMS ao lado do telefone ("Send SMS to …"). A janela Enviar SMS abre com o Destinatário preenchido. Escreva a Mensagem (até 1.600 caracteres) e envie. Enquanto você digita, a janela mostra quantos segmentos de SMS a mensagem precisa, por exemplo "2 segmento(s) de SMS".
• Nos detalhes do lead, abra a aba SMS para ver o Histórico de SMS, enviar uma nova mensagem ou clicar em Sincronizar para buscar respostas no Twilio.

Os telefones devem estar no formato E.164, por exemplo +5511999999999. Números sem + são completados com o código de país padrão. Cada mensagem enviada e cada resposta ficam registradas na atividade do lead.

Para enviar SMS a muitos leads de uma vez, crie uma campanha de SMS em Campanhas > Nova Campanha > SMS (abrir campanha de SMS). Textos longos são divididos em vários segmentos de SMS (cerca de 160 caracteres cada); o editor de campanha mostra a quantidade de segmentos.

Custos e limites

• O Twilio cobra cada mensagem, número de telefone e serviço diretamente na sua conta Twilio. O NextCRM não cobra por SMS.
• Preços, regras de remetente e exigências de cadastro dependem do país de destino. Alguns países exigem que você registre a empresa ou o remetente antes de enviar; confira isso na sua conta Twilio.
• Contas de avaliação (trial) do Twilio têm restrições (por exemplo, normalmente só enviam para números verificados). Faça o upgrade da conta Twilio antes de entrar em produção.

Solução de problemas

• "Twilio credentials are incomplete." Informe o Account SID e o Auth Token e salve.
• "Twilio sender is incomplete." Adicione um Número de Origem ou um Messaging Service SID.
• O teste de conexão falha: salve as configurações com Habilitar integração de SMS ativado primeiro, e confira se o SID e o token são da mesma conta e do mesmo ambiente do Twilio.
• As respostas não aparecem: verifique se a URL do webhook de entrada está configurada no número ou no Messaging Service no Twilio e se o telefone do lead corresponde ao número de quem respondeu. Use Sincronizar na aba SMS do lead.

Artigos relacionados

• Campanhas de e-mail
• Configuração de e-mail (SMTP e IMAP)
• Configuração do WhatsApp
• Leads e pipeline