Mensagens SMS/WhatsApp (Twilio)

Envie e receba SMS e WhatsApp usando a sua própria conta Twilio (modelo BYO), direto do contato ou lead.

A integração de Mensagens usa a SUA conta Twilio (modelo BYO, "traga a sua própria conta"). As mensagens são enviadas e cobradas na sua conta Twilio: não há custo, margem nem intermediação nossa. Nós só programamos os campos e o botão para enviar SMS/WhatsApp e registrar as respostas.

A integração nasce inerte: nada é enviado até você preencher os campos e ativar. O Auth Token fica cifrado no CRM e nunca é exibido de volta.

Pré-requisitos

• Uma conta Twilio com saldo/plano ativo e um número Twilio habilitado para SMS (e, para WhatsApp, um sender de WhatsApp aprovado na Twilio).
• Acesso ao Console da Twilio para ver o Account SID e o Auth Token e configurar o webhook do número.
• No Sellio, ser administrador para salvar as credenciais e ativar a integração em Configurações → Integrações.

O que você precisa preencher

• Account SID: o identificador da sua conta Twilio, encontrado no Console da Twilio (começa com AC...).
• Auth Token: o token de autenticação da conta, também no Console da Twilio (fica cifrado no CRM).
• Número de SMS (remetente): um número Twilio habilitado para SMS, em formato E.164 (ex.: +15005550006). Necessário para enviar SMS.
• Número de WhatsApp (remetente): o seu sender de WhatsApp aprovado na Twilio, em E.164 (sem o prefixo whatsapp:). Necessário para enviar WhatsApp.

Como configurar

1. Abra Configurações → Integrações e localize o cartão "Mensagens SMS/WhatsApp (Twilio)".
2. Cole o Account SID e o Auth Token; informe o número de SMS e/ou de WhatsApp e clique em "Salvar credenciais".
3. Copie a "URL do webhook (Twilio)" que aparece e, no Console da Twilio, no seu número, aponte o campo "A message comes in" (webhook) e o "Status callback URL" para essa URL.
4. Volte ao CRM e clique em "Ativar".

Como enviar uma mensagem

1. Abra um Contato ou Lead que tenha telefone (campo Telefone ou Celular).
2. No quadro "Mensagens (SMS/WhatsApp)", clique em "Enviar SMS/WhatsApp".
3. Escolha o canal (SMS ou WhatsApp), confira o número, escreva a mensagem e clique em "Enviar".
4. A mensagem é registrada no histórico do registro (e na timeline). As respostas do cliente chegam pelo webhook e aparecem no mesmo histórico.

Trate a URL do webhook e o Auth Token como secretos (por segurança, o CRM não mostra o token salvo de volta). O CRM verifica a assinatura X-Twilio-Signature das chamadas recebidas usando o seu Auth Token.

Como testar

1. Abra um Contato ou Lead com telefone e, no quadro "Mensagens (SMS/WhatsApp)", clique em "Enviar SMS/WhatsApp".
2. Escolha o canal, escreva uma mensagem curta e envie para um número seu.
3. Confirme que a mensagem chegou ao celular e que ficou registrada no histórico do registro.
4. Responda do celular e verifique que a resposta aparece no mesmo histórico (isso valida o webhook de entrada).

Solução de problemas

• 401/authenticate: Account SID ou Auth Token errados. Recole o Auth Token (ele não volta do servidor) e confira o Account SID (começa com AC).
• Erro ao enviar / número inválido: use o formato E.164 (ex.: +5511999998888) no remetente e verifique se o número Twilio está habilitado para o canal (SMS x WhatsApp) e para o país de destino.
• WhatsApp não envia: o sender de WhatsApp precisa estar aprovado na Twilio e informado sem o prefixo whatsapp:. Fora da janela de 24h, o WhatsApp exige um template aprovado.
• Não recebo as respostas: no Console da Twilio, no seu número, aponte "A message comes in" e o "Status callback URL" para a "URL do webhook (Twilio)" do CRM.
• Chamada recebida rejeitada: a assinatura X-Twilio-Signature não confere (Auth Token divergente). Reinforme o mesmo Auth Token no CRM.

Conectar o GoTo (VoIP · SMS · Reuniões)

O GoTo é uma alternativa BYO ("traga a sua própria conta") para voz, SMS e reuniões: conecte a sua conta GoTo e passe a ligar com um clique, enviar SMS e gerar links de reunião pelo CRM. A integração fica inerte até você salvar a credencial do app OAuth e conectar. A conexão acontece em um popup, então você nunca sai do CRM.

1. No GoTo Developer Center, crie um app OAuth e adicione a "Redirect URI" exata mostrada no cartão do GoTo (Configurações → Integrações) às URIs de redirecionamento autorizadas.
2. No cartão do GoTo, cole o Client ID e o Client Secret (e, opcional, um número de origem padrão) e clique em "Salvar credenciais".
3. Clique em "Conectar": um popup abre a tela de consentimento do GoTo. Aprove e o popup se fecha sozinho — o cartão passa a mostrar "Conectado".
4. Para revogar o acesso, use "Remover credenciais" no cartão. Use "Reconectar" para renovar a autorização.

Abrir este artigo dentro do sistema →