Your AI Connector Docs

Mensagens SMS

Envie e receba mensagens de texto (SMS) através da plataforma e receba mensagens multimédia (MMS) recebidas. O serviço de SMS é assegurado pela Twilio, um fornecedor líder de serviços telefónicos, proporcionando-lhe uma cobertura fiável e disponibilidade de números de telefone em todo o mundo.


Visão geral

As mensagens SMS na aplicação permitem-lhe:

  • Envie e receba mensagens de texto com contactos
  • Receba mensagens multimédia (imagens, vídeos, documentos) via MMS
  • Automatize respostas com um Agente de IA
  • Execute transmissões baseadas em SMS, incluindo envios em massa
  • Trate da conformidade regulamentar para diferentes países

Como funciona o SMS

O SMS funciona na sua própria conta Twilio, ou no seu próprio telemóvel Android através do Android SMS gateway caso prefira não utilizar a Twilio. De qualquer forma, conta para o limite de canais do seu plano. Esta página aborda a rota da Twilio. O SMS na maioria dos países é fortemente regulamentado — por exemplo, A2P 10DLC nos EUA (um sistema de registo que as operadoras utilizam para confirmar que uma empresa é realmente quem diz ser, para que as suas mensagens não sejam bloqueadas como spam), registo de marca na Austrália, aprovação de ID de remetente na Europa, etc. — e a conformidade tem de ser submetida em nome do próprio remetente da mensagem. Por essa razão, a plataforma não oferece números de SMS geridos — o utilizador traz a sua conta Twilio, paga diretamente à Twilio pelos números e pelas taxas por mensagem, e a plataforma trata do encaminhamento, da IA e da camada de conversação sobreposta.

O que obtém assim que estiver ligado:

  • Cobertura global em todos os países suportados pela Twilio
  • Tipos de números incluindo locais, móveis e gratuitos
  • Suporte para MMS recebidas — o conteúdo multimédia que um contacto lhe envia é guardado na conversação (o envio de MMS de saída não é suportado; o SMS de saída é apenas texto)
  • Sem cobrança de créditos pela plataforma para entrega de SMS — paga apenas as taxas de operadora por segmento da Twilio diretamente. Se um Agente de IA gerar a resposta, essa resposta de IA ainda utiliza créditos de IA, tal como em qualquer outro canal.

A API do WhatsApp Business é diferente. Os números da API do WhatsApp Business podem ser executados na plataforma Twilio gerida ou na sua própria Twilio. Se ligou a sua própria chave Anthropic (BYOK), as mensagens de WhatsApp da Twilio gerida custam 0,05 créditos cada, recebidas e enviadas, e em todas as outras contas esses custos de entrega são cobertos pela sua taxa de crédito de IA. A partir de 1 de outubro de 2026, cada número gerido será cobrado por mensagem, recebida e enviada, independentemente de utilizar ou não a sua própria chave. Consulte WhatsApp Business para esse caminho.

Não confunda isto com o cartão Conta Twilio. A página Canais também tem um cartão Conta Twilio separado, mais abaixo na lista do que SMS via Twilio. Este move o seu lado WhatsApp para a sua própria conta Twilio: os números comprados através da plataforma são libertados e pode então anexar um remetente de WhatsApp que já exista na sua própria conta Twilio (e no seu próprio negócio Meta). Não está relacionado com a ligação SMS nesta página — alterá-lo não afeta o seu número de SMS. Consulte Fornecedor de SMS para obter o guia completo desse cartão.

Não tem Twilio? Use o seu próprio telemóvel Android (Beta). Para mensagens de conversação de baixo volume, pode ignorar completamente a Twilio e enviar SMS através do seu próprio telemóvel Android e plano de operadora. Consulte Android Phone as SMS Gateway. É ideal para respostas individuais e conversas com IA — as transmissões de SMS em massa ainda requerem a Twilio.


Ligar a sua conta Twilio

  1. Na barra lateral esquerda, clique em Definições perto da parte inferior.
  2. Na barra lateral de Definições, em Canais, clique em Canais.
  3. Encontre o cartão SMS via Twilio e clique em Ligar. (Na página Canais, este cartão encontra-se mais abaixo na lista, abaixo do Telegram, LINE e dos outros cartões de canal.)

A ligação é feita através de um formulário único, não de um assistente de vários passos:

  1. Account SID — cole-o a partir da sua Consola Twilio, em Account.
  2. Auth Token — cole-o a partir do mesmo local, em Account → API credentials. É validado junto da Twilio e nunca mais lhe é mostrado posteriormente.
  3. Phone number — o número com capacidade de SMS na sua conta Twilio, em formato internacional (por exemplo, +14155552671).
  4. Clique em Connect Twilio. A aplicação valida as credenciais e configura automaticamente o webhook de entrada no seu número Twilio — não existe qualquer passo separado de configuração de webhook ou de mensagem de teste.

Já está a utilizar este número para o WhatsApp? O número pode ser o mesmo que associou como o seu remetente da API do WhatsApp Business. Ligá-lo aqui adiciona SMS e não afeta o WhatsApp: o número aparece em ambos os cartões e cada canal mantém os seus próprios requisitos da Twilio (um remetente de WhatsApp aprovado para o WhatsApp, A2P ou registo de remetente para SMS). Remover o WhatsApp desse número mais tarde mantém o SMS a funcionar: o remetente do WhatsApp e a sua taxa mensal são removidos, mas o lado do SMS permanece ligado. Libertar o próprio número remove ambos.

Uma vez ligado, o cartão mostra o seu número e um Account SID mascarado, além das ações Edit e Disconnect. Logo após a ligação (ou edição), o URL do webhook que a aplicação configurou é mostrado uma vez para referência — não é guardado, por isso, se precisar de o ver novamente, clique em Edit e volte a introduzir as mesmas credenciais.

Onde encontrar o seu Account SID e Auth Token: inicie sessão em console.twilio.com. Ambos encontram-se no painel principal, no painel Account Info. Pode comprar e gerir números de SMS diretamente na Consola Twilio — a plataforma não possui a sua própria interface de compra de números para SMS.

Pode ligar um número Twilio de cada vez. Para utilizar um número diferente, clique em Edit no cartão ligado e introduza as novas credenciais — o número antigo é desligado e o novo é configurado.

Atualizar ou desligar SMS

Para alterar o seu número de SMS ou as credenciais Twilio, abra SMS via Twilio na página Canais, clique em Editar e volte a introduzir os três campos (Account SID, Auth Token e número de telefone — o formulário requer sempre os três, uma vez que o token de autenticação nunca é enviado de volta para o navegador para pré-preenchimento). Para deixar de utilizar SMS, clique em Desligar; isto limpa o webhook de entrada no seu número Twilio e remove a ligação. As conversas existentes não são eliminadas. Se o mesmo número também utilizar a API do WhatsApp Business, a opção Desligar apenas interrompe o SMS e o WhatsApp continua a funcionar.


Enviar e receber SMS

Receber mensagens

Assim que o seu número estiver ativo, as mensagens SMS recebidas são automaticamente encaminhadas para a plataforma:

  1. Um contacto envia um texto para o seu número de telefone.
  2. A mensagem aparece em Conversas em tempo real.
  3. Um novo contacto é criado automaticamente se esta for a primeira mensagem desse remetente.
  4. Se um Agente de IA estiver a tratar da conversação relevante, este responde automaticamente.

Enviar mensagens

  • Resposta manual: Abra uma conversa em Conversas e escreva a sua resposta.
  • Transmissões: Configure uma transmissão de SMS em massa para chegar aos contactos em escala — o SMS é totalmente suportado como um canal de saída, tal como o WhatsApp. Consulte Transmissões.
  • Agente de IA: Atribua um Agente para responder automaticamente às mensagens recebidas.
  • Mensagens agendadas: Agende mensagens para serem enviadas a uma hora específica.

MMS (Mensagens Multimédia)

Os números SMS suportam MMS recebidos, pelo que, quando um contacto lhe envia multimédia, esta é guardada na conversa:

  • Imagens (JPEG, PNG, GIF)
  • Vídeos (MP4)
  • Ficheiros de áudio
  • Documentos (PDF)

Os anexos de multimédia são guardados automaticamente e acessíveis na vista de conversação, incluindo uma fotografia enviada sem texto, e o seu agente de IA consegue ver imagens e ler mensagens de voz e vídeo como texto. Quando uma mensagem contém vários anexos, apenas o primeiro é guardado. O envio de MMS a partir da plataforma não é atualmente suportado — o envio de SMS é apenas de texto.

Nota: A disponibilidade de MMS recebidas varia consoante o país e o fornecedor. O MMS é amplamente suportado nos EUA e no Canadá, mas pode ter suporte limitado noutros locais.


Adicionar uma ligação de “clicar para enviar SMS” ao seu site

Não existe um widget flutuante de SMS como existe para o WhatsApp, mas pode colocar um botão ou uma ligação no seu site (ou num e-mail, código QR, etc.) que abre a aplicação de mensagens do visitante com o seu número pronto a enviar uma mensagem. Isto utiliza uma ligação sms: simples.

O formato é:

sms:+NUMBER

Utilize o seu número no formato internacional, incluindo o sinal de mais. Por exemplo:

sms:+15551234567

Colocar num botão

Ligue qualquer botão ou texto a esse endereço:

<a href="sms:+15551234567">Text us</a>

Num construtor de sites (Wix, Squarespace, WordPress, Webflow, etc.), adicione um botão como habitualmente e cole sms:+15551234567 no campo de “ligação” / “URL”.

Pré-preencher uma mensagem

Pode pré-preencher a mensagem que o visitante irá enviar. O iPhone e o Android esperam isto de formas ligeiramente diferentes, por isso utilize este formato combinado para cobrir ambos:

sms:+15551234567?&body=Hi!%20I%20have%20a%20question

Os espaços na mensagem devem ser escritos como %20.

É bom saber.

  • As hiperligações de “clicar para enviar mensagem” só funcionam num dispositivo que tenha uma aplicação de mensagens — funcionam em telemóveis, mas num computador de secretária, clicar na hiperligação normalmente não faz nada.
  • Estas hiperligações abrem a própria aplicação de mensagens do visitante; a primeira mensagem é enviada a partir do número de telemóvel do visitante, não do seu. A conversa aparece então nas Conversas como qualquer outro SMS recebido assim que o visitante carregar em enviar.
  • Evite colocar uma hiperligação sms: dentro de um SMS que envia — a maioria dos telemóveis não a tornará clicável. Funcionam melhor em páginas web, e-mails e códigos QR.

Chamadas de voz para o seu número de SMS

As pessoas irão ligar para o número a partir do qual envia mensagens — é um número de telefone. Existe uma coisa que a plataforma pode fazer com essas chamadas: enviar uma mensagem de resposta a quem ligou quando ninguém atende. Esse é o interruptor Responder a chamadas perdidas com SMS abaixo.

Deixe esse interruptor desligado e nada muda: as chamadas de voz para o seu número Twilio SMS ligado são geridas inteiramente pela sua própria conta Twilio, e a plataforma não instala uma saudação de correio de voz, gravação ou transcrição nos números que traz. Se deseja correio de voz no seu número SMS, configure-o na sua Consola Twilio.

Nota: O correio de voz automatizado da plataforma aplica-se apenas aos números comprados através da plataforma para WhatsApp, não aos números Twilio que liga para SMS. As chamadas nunca são atendidas, gravadas ou transcritas na aplicação em qualquer um dos tipos de número.

Responder a chamadas perdidas por texto

Em Definições → Canais, o cartão SMS via Twilio tem um interruptor Responder a chamadas perdidas com SMS. Ligue-o, mantenha ou altere o texto que quem liga deve receber (começa como “Desculpe, não conseguimos atender a sua chamada. Como podemos ajudar? Responda aqui e entraremos em contacto consigo imediatamente.”) e clique em Guardar. Também pode preencher Reencaminhar chamadas para — um número de telefone em formato internacional, como +14155550123 — e a chamada toca primeiro aí.

O que quem liga experiencia depende desse campo:

  • Com um número de reencaminhamento. A chamada toca no telefone que indicou durante 25 segundos. Atenda e é tudo — nada mais acontece. Se ninguém atender, a linha estiver ocupada, a chamada for recusada ou quem liga desligar enquanto ainda está a tocar, a pessoa é guardada como um contacto SMS, uma linha de Chamada de voz perdida aparece na sua conversa e a sua mensagem é enviada para eles como um SMS a partir do seu número SMS.
  • Sem um número de reencaminhamento. Quem liga ouve um sinal de ocupado — a chamada nunca é atendida — e recebe a sua mensagem imediatamente.

De qualquer forma, quando respondem a esse SMS, a conversa é gerida pelo Agente de IA do número, como qualquer nova conversa SMS. Alguém que ligue com um número oculto ou anónimo não recebe mensagem, porque não há número para onde enviar.

Ligar isto assume o controlo das definições de voz do número na sua conta Twilio. Qualquer configuração de voz que o número tivesse é guardada primeiro e reposta no momento em que desliga o interruptor, para que possa experimentar e mudar de ideias.

A mensagem é enviada através da sua própria conta Twilio, pelo que se aplicam as suas taxas normais de SMS da Twilio. A própria resposta automática é uma automatização comum chamada Resposta por SMS a chamada perdida · o seu número, por isso aparece em AI Studio → Automatizações e cada execução utiliza os habituais 0,25 créditos. Quer mais do que uma mensagem — uma mensagem diferente fora do horário de expediente, um agente específico para quem liga e não é atendido, um lembrete se não responderem? Abra-a em Automatizações e edite-a lá; assim que alterar a sua estrutura, o cartão de Canais mostra Personalizado em Automatizações e não altera as suas edições, enquanto o interruptor continua a ligá-la e desligá-la. O interruptor é também o que faz com que o gatilho de Chamada perdida funcione para este número: é a única coisa que aponta as chamadas do número para Your AI Connector na sua conta Twilio, pelo que uma automatização criada manualmente para o número SMS não faz nada enquanto o interruptor estiver desligado. Ligue primeiro o interruptor e, em seguida, edite a automatização que este criou. O gatilho em si é descrito aqui: Exemplo: transformar uma chamada WhatsApp perdida numa conversa.

O mesmo interruptor existe em cada número de WhatsApp Web, onde a mensagem é enviada via WhatsApp — veja Responder a chamadas perdidas com SMS. Não está disponível para números de WhatsApp Business API, para números comprados através da plataforma ou para o gateway de SMS Android.


Conformidade Regulatória

A regulação de SMS é gerida diretamente com a Twilio na sua própria conta. A plataforma não apresenta conformidade em seu nome para SMS — isso tem de ser feito em nome da sua empresa. Requisitos comuns:

  • A2P 10DLC (Estados Unidos) — registe a sua marca e campanha no The Campaign Registry através da Twilio antes de enviar para números dos EUA.
  • Verificação de Toll-Free (Estados Unidos e Canadá) — necessária para o envio de SMS através de números gratuitos (toll-free).
  • Registo de Sender ID (grande parte da Europa, Médio Oriente, Ásia-Pacífico) — a Twilio gere o processo de submissão.
  • Documentos de identificação (países regulados como Alemanha, França, Índia, etc.) — carregados na sua Consola Twilio ao comprar um número.

Se a sua conta necessitar de um pacote regulamentar formal (números gratuitos nos EUA, telemóveis no Reino Unido e semelhantes), o cartão Conformidade regulamentar na página Canais inicia e acompanha esse envio com a Twilio.

Consulte as diretrizes regulamentares da Twilio para obter a análise completa por país.

Melhores Práticas de Conformidade de Mensagens

  • Obtenha consentimento antes de enviar mensagens SMS para contactos. Isto é um requisito legal na maioria das jurisdições (TCPA nos EUA, RGPD na Europa, etc.).
  • Inclua instruções de cancelamento de subscrição nas mensagens de difusão (por exemplo, “Responda STOP para cancelar a subscrição”).
  • Respeite os pedidos de cancelamento de subscrição imediatamente. Um contacto que responda STOP (ou STOPALL, UNSUBSCRIBE, CANCEL, QUIT, END) é automaticamente marcado como Não Incomodar (Do Not Disturb), e todos os envios de SMS e difusões de SMS subsequentes ignorá-lo-ão.
  • Mantenha os seus próprios registos de consentimento. Não existe um campo de consentimento na importação, por isso, se importar leads (incluindo leads compradas com opt-in documentado), guarde a prova de consentimento do seu lado.
  • Identifique-se nas mensagens — os destinatários devem saber quem os está a contactar.
  • Siga os regulamentos locais dos países onde os seus contactos se encontram.

Resolução de Problemas

Mensagens Não Entregues

  • Verifique se o número de telefone do destinatário está no formato internacional correto (por exemplo, +1234567890).
  • Verifique se a sua conta Twilio tem um saldo positivo e se as credenciais ligadas ainda são válidas.
  • Certifique-se de que o número não foi desativado ou libertado na sua Consola Twilio.
  • Verifique o estado da mensagem na vista de conversação para obter detalhes sobre erros — os códigos de erro da Twilio são apresentados diretamente e cada um deles é explicado no Registo de Erros.
  • Alguns países bloqueiam mensagens provenientes de números estrangeiros — compre um número Twilio local para esse país.

Número Não Envia ou Recebe

  • Confirme que o número está ativo na sua Consola Twilio.
  • Confirme que as credenciais da Twilio ligadas na página Canais ainda correspondem à conta que detém o número.
  • Para países regulamentados, confirme que os passos de conformidade A2P 10DLC, ID de remetente ou outros passos da Twilio foram concluídos.

MMS Não Funciona

  • Confirme se o MMS é suportado no país do destinatário.
  • Verifique se o tamanho do ficheiro está dentro dos limites (normalmente 5MB para MMS).
  • Verifique se o formato do ficheiro é suportado (JPEG, PNG, GIF, MP4, PDF).

Não recebo mensagens recebidas

  • Envie um SMS de teste para o seu número de telemóvel a partir do seu telemóvel pessoal.
  • Verifique se o número aparece como ligado na página Canais.
  • Se o problema persistir, tente voltar a ligar o número a partir do cartão SMS via Twilio — a plataforma volta a executar a configuração técnica automaticamente.

Melhores práticas

  • Utilize números locais para os países onde os seus contactos se encontram. As mensagens enviadas a partir de números locais têm taxas de confiança e de entrega mais elevadas.
  • Seja conciso nas mensagens. O SMS tem um limite de 160 caracteres por segmento. Mensagens mais longas são divididas em vários segmentos, o que aumenta o custo.
  • Não dependa de emojis ou símbolos especiais. Para manter cada SMS num único segmento (mais barato), a plataforma limpa automaticamente o texto de saída para a codificação SMS padrão: os emojis são removidos e as aspas curvas, travessões, reticências e caracteres semelhantes são convertidos nos seus equivalentes simples. As letras acentuadas fora do conjunto SMS padrão são enviadas sem o acento (o ũ torna-se u, o ê torna-se e). As mensagens num alfabeto não latino (árabe, chinês, cirílico, etc.) são enviadas tal como foram escritas, numa codificação que permite menos caracteres por SMS (70 em vez de 160), pelo que custam mais segmentos.
  • Envie as mensagens na altura certa. Evite enviar mensagens fora do horário de expediente no fuso horário do destinatário.
  • Monitorize as taxas de entrega. Se notar uma entrega fraca em determinadas regiões, considere adquirir um número local para esse país para melhorar a confiança e a capacidade de entrega.
  • Atribua um Agente de IA para responder rapidamente às mensagens recebidas, especialmente fora do horário de expediente.