SMS

Esta página é para quem atende por mensagem de texto. O ChatMade não tem número próprio: você traz o seu, de um dos seis provedores implementados.

Os seis provedores

Nome na lista	Credenciais que ele pede
Twilio	Account SID, Auth token
Vonage (Nexmo)	API key, API secret, Signature secret (optional)
MessageBird (Bird)	Access key, Signing key (optional)
Plivo	Auth ID, Auth token
Brevo	API key
AWS SNS	AWS access key ID, AWS secret access key, AWS region (e.g. us-east-1), SNS topic ARN (optional)

Bom saber: a descrição do cartão na tela diz “Connect a Twilio number so customers can text your AI agent.” — mencionando só o Twilio. Isso é texto desatualizado: são seis provedores, e todos os seis funcionam. A lista real está no seletor do formulário.

O que você precisa antes

• Uma conta em um dos seis provedores, com um número (ou um identificador de remetente) já ativo.
• As credenciais da tabela acima.
• Um administrador do ChatMade com a permissão manage_organization.

Onde pegar cada credencial

• Twilio — no console, na página inicial: Account SID e Auth Token.
• Vonage — no painel, em API settings: a chave e o segredo. O signature secret é opcional e só existe se você tiver ligado a assinatura de webhook.
• MessageBird / Bird — em Developers → API access, crie uma access key ao vivo.
• Plivo — no console, na página inicial: Auth ID e Auth Token.
• Brevo — em SMTP & API → API Keys.
• AWS SNS — um par de chaves de acesso do IAM com permissão de publicar no SNS, mais a região. O ARN do tópico é opcional.

Conectar

1. No painel, abra Settings → Integrations (“Configurações → Integrações”).
2. Ache o cartão SMS. Clique em Connect (“Conectar”). Abre o modal Connect SMS, que explica:

Choose your SMS provider, enter the number to send from, and its API credentials. After connecting, set the URL shown as the number’s inbound-message webhook (SNS uses an HTTPS topic subscription).

3. Em SMS provider (“Provedor de SMS”), escolha um dos seis. Vem com Twilio selecionado.
4. Em Phone number / sender ID (“Número / identificador de remetente”), coloque o número em formato internacional, tipo +5551999999999.
5. Preencha as credenciais. Os campos mudam conforme o provedor que você escolheu — a lista vem do servidor, não é fixa na tela.
6. Clique em Connect (“Conectar”).

A conta conectada aparece com um nome gerado, tipo SMS +5551999999999 (Twilio).

O webhook de entrada

Depois de conectar, a tela mostra o passo Webhook URL — set this on your provider (“URL de webhook — configure no seu provedor”), com o botão Copy (“Copiar”). O formato é:

{seu-backend}/api/v1/webhooks/sms/{provedor}/{id-da-conta}?token={segredo}

Cole essa URL na configuração de mensagem recebida do seu provedor — no Twilio, o campo “A message comes in”; no Plivo, a Message URL; e assim por diante. No AWS SNS, o caminho é diferente: você cria uma assinatura HTTPS do tópico apontando para essa URL, e o ChatMade confirma a inscrição sozinho.

Atenção: a URL que aparece logo depois de conectar vem sem o ?token=. É um defeito conhecido. Para Brevo, MessageBird e Vonage sem segredo de assinatura, o token é obrigatório — sem ele, o provedor recebe 403 Invalid token e nenhuma mensagem entra.

A solução é simples: feche o modal, clique em Manage (“Gerenciar”) no cartão do SMS e copie a URL de lá. Essa vem completa, com o token.

Três provedores assinam o webhook e por isso não dependem do token: Twilio (X-Twilio-Signature), Plivo (X-Plivo-Signature-V3) e AWS SNS. O Vonage assina só se você tiver configurado o segredo de assinatura.

Escolha o agente

O modal termina pedindo o agente, em AI agent that answers this channel (“Agente de IA que responde neste canal”), com o botão Assign agent (“Atribuir agente”).

Testar

Não há botão de teste. As credenciais são verificadas no momento de conectar — mas essa verificação depende do provedor, e alguns não a implementam. O teste confiável é mandar um SMS de verdade para o número e ver a resposta chegar.

Limites

• Resposta cortada em 1.600 caracteres. Lembre que a operadora cobra por segmento: um SMS comum tem 160 caracteres, e 1.600 são dez segmentos.
• Tempo limite de 15 segundos por chamada ao provedor.
• Trava contra mensagem duplicada de 1 hora.

Atenção: SMS não tem mídia neste sistema — nem MMS, nem link de imagem gerado pelo agente. É texto e só.

O ChatMade devolve ao Twilio uma resposta TwiML vazia, de propósito, para que o Twilio não mande nenhuma resposta automática por conta própria.

Custo

Cada mensagem enviada é cobrada pelo seu provedor, não pelo ChatMade. Como a resposta pode chegar a 1.600 caracteres, vale ajustar as instruções do agente para respostas curtas neste canal — dez segmentos por resposta somam rápido.

Desconectar

Botão Disconnect (“Desconectar”) no cartão.

Próximo passo

Se o seu público está no Japão, na Tailândia ou em Taiwan, veja LINE. Caso contrário, siga para Caixa de entrada.