SMS (Twilio)

Conecte um número Twilio ao Aillom MEX para atender mensagens SMS (e receber MMS) automaticamente com IA.

Pré-requisito: Uma conta na Twilio e um número habilitado para SMS (ou um Messaging Service).

1. Obter as Credenciais na Twilio

No Console da Twilio, localize na página inicial (Account Info):

Em vez de um número fixo, você pode informar um Messaging Service SID (começa com MG...) para usar um pool de números.

2. Conectar pelo Painel

No painel do MEX, vá em Canais → Novo Canal → SMS (Twilio) e informe:

• Account SID (AC...)
• Auth Token
• Número Twilio em E.164 (+55...) ou o Messaging Service SID (MG...)
• O Agente que vai responder neste canal

Ao salvar, o MEX configura o webhook do número automaticamente (smsUrl) apontando para o endpoint de inbound. Nenhuma configuração adicional na Twilio é necessária.

3. Configurar o Webhook Manualmente (opcional)

Caso prefira configurar manualmente — ou esteja usando um número que já possui outra integração — defina o webhook no Console Twilio:

1. Acesse Phone Numbers → Manage → Active numbers → seu número
2. Vá até a seção Messaging
3. Em "A message comes in", selecione Webhook
4. Cole a URL de inbound abaixo e selecione o método POST

As requisições chegam form-encoded e são validadas pelo header X-Twilio-Signature, garantindo que o evento veio realmente da Twilio.

4. Fluxo de Mensagens

Quando um usuário envia um SMS para o seu número:

1. A Twilio faz um POST (form-encoded) para https://mex.aillom.com.br/api/webhook/twilio
2. O MEX valida a assinatura X-Twilio-Signature e identifica o canal e o Agente vinculado
3. A IA processa a mensagem com contexto, histórico e conversation_vars
4. A resposta é enviada de volta pela Twilio Messages API

Em MMS (mensagens com imagem), o MEX aplica OCR automaticamente para extrair o texto da imagem e incluí-lo no contexto do Agente.

Recursos Suportados