O canal SMS usa a conta da sua própria empresa num provedor de SMS: Twilio, Zenvia ou SMS Dev. O Codewo envia e recebe pelo provedor, e o provedor cobra cada mensagem direto da sua empresa. Depois de criado, o canal fica desativado até ser liberado pelo suporte do Codewo.
O que é
Um número (ou remetente) de SMS atendido na Caixa de Entrada. A resposta do cliente vira conversa, como nos outros canais, e a equipe responde de lá.
- Só texto. O SMS não leva foto, áudio nem arquivo, nos dois sentidos. Anexo colocado numa conversa de SMS não chega ao cliente.
- O cliente é identificado pelo número. O contato novo nasce com o número como nome, por exemplo "(19) 99999-9999". Troque pelo nome certo na ficha.
- Sem grupos, sem editar ou apagar o que foi enviado e sem janela de 24 horas.
Como funciona
- Envio: o Codewo passa o texto ao provedor com as credenciais da sua conta, e o provedor entrega ao celular do cliente.
- Recebimento: quando o cliente responde, o provedor avisa o Codewo num endereço próprio do canal, a URL do Webhook. É você quem cadastra esse endereço no painel do provedor.
- Conferência: cada aviso que chega é conferido antes de entrar. No Twilio, a conferência usa a assinatura que o próprio Twilio calcula com o seu Auth Token.
- Liberação: todo canal SMS nasce desativado, e a ativação é feita pelo suporte do Codewo. Se você tentar Ativar Canal, o Codewo avisa que "A ativação de canais SMS requer liberação pelo suporte".
| Provedor | Enviar | Receber respostas |
|---|---|---|
| Twilio | Sim | Sim, depois de cadastrar a URL do Webhook no número |
| Zenvia | Sim | Confirme com o suporte do Codewo na liberação do canal |
| SMS Dev | Sim | Confirme com o suporte do Codewo na liberação do canal |
Antes de começar
Tenha uma conta ativa no provedor, com número ou remetente contratado e saldo. O Codewo pede:
| Provedor | Campos no Codewo | Onde encontrar |
|---|---|---|
| Twilio | Account SID, Auth Token e Número de Telefone (E.164) | Console do Twilio. O número é o comprado no Twilio, no formato internacional, como +5519999999999 |
| Zenvia | API Token e Sender ID (número ou shortcode) | Painel da Zenvia, em Integrações → API |
| SMS Dev | Chave Key | Painel do SMS Dev, em Configuração → Minha Conta → Perfil |
Passo a passo
Exemplo: uma clínica quer receber pelo Codewo as respostas dos lembretes que manda por SMS, usando o número que já tem no Twilio.
- Em Configurações → Canais, clique em Adicionar Canal, escolha SMS e clique em Próximo.
- Etapa Provedor: escolha Twilio, Zenvia ou SMS Dev.
- Etapa Credenciais: preencha os campos e clique em Testar Conexão. Com as credenciais certas, aparece "Conexão estabelecida com sucesso!", com a conta, o número e o saldo quando o provedor informa. O teste confere o acesso à conta e não envia nenhum SMS. O número ou remetente só é posto à prova no primeiro envio, então confira com atenção.
- Etapa Detalhes: o Nome do Canal vem como "SMS - Twilio". Troque se quiser e clique em Criar Canal. Aparece o aviso "Canal SMS criado como desativado. Entre em contato com o suporte para liberação do canal."
- No cartão do canal, abra o menu e clique em Configurar. Na seção Webhook, copie a URL do Webhook pelo botão ao lado dela.
- Cole a URL no painel do provedor. As instruções aparecem logo abaixo da URL, no próprio Codewo:
- Twilio: Phone Numbers → Manage → Active Numbers. Escolha o número e cole a URL em Messaging, no campo "A message comes in", como Webhook.
- Zenvia: Integrações → Configuração de Callback.
- SMS Dev: Api & Integrações → Configuração de Callback, nos campos de retornos recebidos (MO) e de situação das mensagens (DLR).
- Peça ao suporte do Codewo a liberação do canal. Na Zenvia e no SMS Dev, peça também a confirmação de que o recebimento das respostas está funcionando.
- Com o canal ativo, faça um teste de ida e volta com um celular da equipe e confira se a resposta aparece na Caixa de Entrada. Só divulgue o número para respostas depois desse teste.
Mandando SMS
- Responder. Nas conversas que chegam por SMS, é só responder como em qualquer canal.
- Começar pelo Codewo. Na Nova Conversa da Caixa de Entrada, só WhatsApp e e-mail começam conversa com quem nunca falou pelo canal. Para mandar SMS a um cliente que ainda não escreveu por esse canal, vincule o canal na ficha dele: aba Canais, Adicionar, escolha o canal SMS, informe o número e clique em Vincular. Depois disso, ao escolher esse contato na Nova Conversa, o canal SMS aparece como opção.
- Transmissões. Escolha o canal SMS ao criar a transmissão. Ela vai para os contatos vinculados a esse canal, só com texto.
- Automações. O passo de enviar mensagem responde pelo canal da conversa: numa conversa de SMS, sai por SMS.
Tamanho da mensagem
O Codewo não corta o texto. O limite é do próprio SMS: em geral, até 160 caracteres por parte num texto sem acento, ou 70 quando aparecem letras como ã, õ, á e ê, ou emoji. Texto maior é dividido em partes ou recusado, conforme o provedor, e cada parte costuma ser cobrada como um SMS. Confira a regra e o preço no contrato do seu provedor.
Pegadinhas comuns
- Canal desativado logo depois de criado é o normal: a liberação é feita pelo suporte do Codewo.
- A resposta do cliente não aparece. Confira se a URL do Webhook foi colada inteira, exatamente como aparece em Configurar, e no campo certo do painel do provedor. No Twilio, qualquer diferença no endereço faz o aviso ser recusado, porque a assinatura é calculada sobre ele. Na Zenvia e no SMS Dev, e sempre que estiver tudo certo e mesmo assim nada chegar, fale com o suporte do Codewo informando o provedor.
- Trocou o Auth Token ou a chave no provedor? O canal para de enviar e de receber, e a tela Configurar não troca as credenciais de um canal SMS. Fale com o suporte do Codewo.
- Número sem código do país é tratado como brasileiro (+55). Cadastre número de fora sempre com o código do país.
- Sem origem do lead. Contato que nasce por SMS não recebe origem no relatório de atribuição.
- O custo é do provedor. Cada SMS, e cada parte de um texto longo, é cobrado pelo provedor na conta da sua empresa.
- Sem anexo. Foto e arquivo não vão por SMS; mande um link.
- Atendente virtual. Por SMS, ela não consulta pedido nem proposta do cliente.
Boas práticas
- Diga quem está falando no começo do texto ("Loja Exemplo: seu pedido saiu para entrega"). No SMS, o cliente não vê foto nem nome da empresa como no WhatsApp.
- Textos curtos quando o custo por parte pesa. Acento e emoji diminuem o espaço de cada parte.
- SMS para avisos, WhatsApp para conversa. Lembrete e aviso curto funcionam bem por SMS; atendimento longo rende mais no WhatsApp.
- Defina quem atende o canal, no menu do canal → Quem atende.