Fornecedor de SMS (Traga a sua própria conta Twilio)
Esta página controla a conta Twilio utilizada para a WhatsApp Business API. Por predefinição, a WhatsApp Business API funciona na conta Twilio gerida da plataforma — nunca vê o Twilio e não precisa de se registar no Twilio. Se tiver ligado a sua própria chave Anthropic (BYOK), as mensagens de WhatsApp via Twilio gerido custam 0,05 créditos cada, de entrada e de saída, 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, de entrada e de saída, independentemente de utilizar ou não a sua própria chave. (Os preços das mensagens do próprio WhatsApp mudam a 1 de outubro de 2026 — consulte Custos do WhatsApp e a Alteração de Outubro de 2026.) Isto só é relevante se pretender especificamente que a WhatsApp Business API funcione na sua própria conta Twilio.
O SMS é sempre “Bring Your Own Twilio” (Traga o seu próprio Twilio). A regulamentação de SMS (A2P 10DLC, registo de marca, aprovação de ID de remetente) tem de ser submetida em nome da sua própria empresa, pelo que a plataforma não oferece números de SMS geridos. Configure o SMS separadamente utilizando o cartão SMS via Twilio em Definições → Canais (existe também uma opção de gateway de SMS para telemóveis Android). Esta página — o cartão Conta Twilio — controla a conta da API do WhatsApp Business e não altera o seu número de SMS. Um número da sua própria conta Twilio pode executar simultaneamente a API do WhatsApp Business e o SMS, ligados em qualquer ordem. O número aparece então no cartão da API do WhatsApp Business e no cartão SMS via Twilio, sendo que cada cartão controla apenas o seu próprio canal: remover o número de um não afeta o funcionamento do outro.
Porque haveria de mudar a WhatsApp Business API para a minha própria conta Twilio?
A maioria dos utilizadores não o faria. A conta gerida é mais simples:
- O aluguer de números WhatsApp, a submissão de modelos, o registo de remetentes e o estado de saúde do número são todos geridos por si. Um número alugado aqui custa pelo menos 50 créditos por mês, e esse aluguer inclui a ligação ao WhatsApp — consulte Números de Telefone.
- Não existe uma fatura Twilio separada. Se tiver ligado a sua própria chave Anthropic (BYOK), as mensagens de WhatsApp via Twilio gerido custam 0,05 créditos cada, de entrada e de saída, 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, de entrada e de saída, independentemente de utilizar ou não a sua própria chave. Consulte Custos do WhatsApp e a Alteração de Outubro de 2026 para saber mais sobre a alteração de preços do WhatsApp que entrará em vigor a 1 de outubro de 2026.
- O suporte pode ajudar a depurar problemas de entrega diretamente.
Poderá querer trazer a sua própria conta Twilio se:
- Já possui uma conta Twilio estabelecida com modelos WhatsApp aprovados e números aquecidos que pretende continuar a utilizar.
- A sua empresa tem um motivo de aprovisionamento ou conformidade para pagar diretamente à Twilio.
- Pretende ter total visibilidade sobre a utilização e os preços ao nível da operadora subjacente.
Manter um número aquecido é uma tarefa de dois passos. Mudar a conta (abaixo) apenas altera a conta Twilio através da qual enviamos. O seu número de WhatsApp existente não aparece como um canal até que também o anexe — consulte Anexar um número de WhatsApp que já possui. Faça-o por essa ordem.
Como mudar
Como chegar lá: Definições → grupo Canais → Canais, depois encontre o cartão Conta Twilio.
O que vê depende da sua configuração atual:
Se estiver na conta gerida (predefinição)
Verá uma breve explicação e um botão Gerir no cartão Conta Twilio. Ao clicar nele, abre-se o formulário Mudar para a sua própria conta Twilio, que solicita o seu Account SID e Auth Token da Twilio — com o aviso de ação destrutiva apresentado diretamente na caixa de diálogo.
Antes de confirmar, leia atentamente os avisos — a mudança é destrutiva:
- Todos os números que comprou através da plataforma serão permanentemente libertados. Se quiser continuar a utilizar um número, mantenha-o na conta gerida (não mude) ou compre-o/transfira-o primeiro para a sua própria conta Twilio.
- Os modelos WhatsApp aprovados não serão transferidos. Os modelos residem na Conta WhatsApp Business que detém o remetente — terá de os submeter novamente na sua própria conta e aguardar uma nova aprovação.
- As conversas e o histórico de mensagens existentes permanecem visíveis, mas as novas respostas nos números libertados falharão (o número já não existe).
- Pode voltar a mudar mais tarde, mas obterá uma nova conta gerida sem números e sem modelos — os seus antigos não regressam.
Onde encontrar o seu Account SID e Auth Token: inicie sessão na Consola Twilio em console.twilio.com. Ambos encontram-se no painel principal, no painel “Account Info”. O Account SID começa por AC e tem 34 caracteres.
Após introduzir ambos os valores e confirmar, o sistema:
- Valida se as credenciais funcionam.
- Liberta cada número de telefone gerido da Twilio.
- Fecha a subconta gerida.
- Guarda as suas credenciais para que todo o WhatsApp de saída futuro utilize a sua conta. O seu número de SMS via Twilio ligado separadamente é armazenado de forma independente e não é libertado nem alterado por esta mudança.
Isto pode demorar desde alguns segundos a alguns minutos, caso tenha vários números.
Se já estiver na sua própria conta Twilio
O cartão mostra a sua conta ligada e permite-lhe voltar à configuração gerida.
Voltar à configuração gerida cria uma nova subconta gerida. Como referido acima: não restaura os números ou modelos que tinha anteriormente — começará do zero.
Anexar um número de WhatsApp que já possui
Assim que a conta estiver na sua própria Twilio, o botão Ligar WhatsApp no cartão WhatsApp Business API altera o que oferece: a opção gerida passa a ser Através da sua conta Twilio, que associa um remetente de WhatsApp dentro da conta Twilio que ligou, e a compra de um número gerido deixa de ser oferecida. Isto é intencional — comprar um número ou executar o registo da Meta criaria uma segunda conta Twilio gerida pela plataforma a par da sua, e as suas mensagens seriam então enviadas a partir de uma conta enquanto o número reside na outra.
Antes de começar
O seu número tem de ser já um remetente de WhatsApp funcional dentro da sua própria conta Twilio:
- Está registado como um remetente de WhatsApp na Twilio, associado à sua própria Conta WhatsApp Business.
- A Twilio mostra esse remetente como Online.
Este ecrã não regista nada. Não cria um remetente, não comunica com a Meta e não submete o seu número para aprovação — liga um remetente que já funciona. Se ainda não tiver um, faça primeiro a configuração do remetente de WhatsApp na Twilio.
Passos
- Aceda a Definições → grupo Canais → Canais.
- No cartão WhatsApp Business API, clique em Ligar WhatsApp, escolha Utilizar um número que já possui, e depois Através da sua conta Twilio.
- Introduza o Número de WhatsApp no formato internacional (por exemplo
+31612345678), exatamente como aparece no remetente na Twilio. - Opcionalmente, atribua-lhe uma Etiqueta — um nome para o número dentro da aplicação. Se for deixado em branco, utiliza o nome do seu perfil de remetente na Twilio.
- Clique em Anexar remetente.
Não precisa de voltar a introduzir o seu Account SID ou token de autenticação: já os temos da mudança de conta.
O que acontece nos bastidores
- Procuramos o remetente para esse número na sua conta Twilio e verificamos se a Twilio o tem online.
- Certificamo-nos de que existe um serviço de mensagens na sua conta e apontamos o seu webhook de entrada para nós (criando um, com o nome da aplicação, caso ainda não tenha um). É também isto que faz com que o envio de modelos funcione.
- Associamos o seu remetente a esse serviço de mensagens.
- Apontamos o próprio webhook do remetente para nós, para que as mensagens recebidas cheguem aqui.
- O número aparece na sua lista de números, marcado como Your Twilio (BYO), pronto a ser atribuído a um agente.
Os seus modelos aprovados permanecem exatamente onde estão, na sua própria conta. Nada é submetido novamente e nada é libertado.
Custos
Não existe qualquer taxa de manutenção mensal num número que anexa desta forma — paga à Twilio diretamente pelo número e pelas suas taxas por mensagem. As respostas de IA continuam a utilizar créditos normalmente.
Se não funcionar
- “No WhatsApp sender for … exists in your Twilio account” — o número não está registado como remetente de WhatsApp nessa conta, ou foi introduzido de forma diferente. Verifique o ID de remetente exato na Consola Twilio e volte a introduzi-lo no formato internacional.
- “The WhatsApp sender … is not online in Twilio” — o motivo específico da Twilio está incluído na mensagem. Corrija-o primeiro na Twilio; associar um remetente que a Twilio tem offline apenas causaria uma falha silenciosa mais tarde.
- “… is already connected to another account” — o número está associado a uma conta diferente aqui. Desligue-o primeiro nessa conta.
- “This account is still on the managed Twilio account” — efetue primeiro a mudança acima.
- “we could not update its webhook in Twilio” — o número está associado e enviará mensagens, mas o remetente ainda aponta para qualquer webhook que lá tivesse configurado. Limpe esse webhook no remetente na Consola Twilio para que as mensagens recebidas cheguem até nós.
Limites
- Pode mudar de fornecedor no máximo uma vez a cada 24 horas. Isto evita que saltos repetidos acumulem custos de API da Twilio e limites de taxa.
- O envio de SMS não é de todo afetado por esta definição — se já ligou a sua própria Twilio através do cartão SMS via Twilio, essa é uma ligação diferente e permanece onde está, independentemente do que fizer aqui.
E se algo correr mal?
- “Could not authenticate with the provided Twilio credentials” — verifique novamente o SID (começa com
AC, 34 caracteres) e o token de autenticação. Ambos diferenciam maiúsculas de minúsculas. - “Account is not active” — a conta Twilio que está a tentar utilizar está suspensa ou encerrada. Utilize uma conta ativa.
- “Please wait Xh before switching again” — encontra-se dentro do período de arrefecimento de 24 horas. Aguarde até que termine.
- Partial migration (some numbers released, some not) — execute a mudança novamente. O sistema é idempotente; retoma a partir de onde parou e termina a libertação de tudo o que ainda se encontra na subconta gerida.
Se tiver problemas após a mudança — mensagens de saída não enviadas, modelos não visíveis — contacte o suporte com o seu Account SID (nunca o token de autenticação).
Precisa de ajuda?
Se não tem a certeza se a mudança é a opção certa para si, ou se encontrar dificuldades, contacte o suporte e nós podemos ajudá-lo a decidir.