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 pela plataforma — nunca vê a Twilio e não precisa de se registar na Twilio. Se ligou a sua própria chave Anthropic (BYOK), as mensagens de WhatsApp da Twilio gerida custam 0,05 créditos cada, de entrada e de saída. Em todas as outras contas, esses custos de entrega já estão cobertos pela sua taxa de crédito de IA, pelo que não existe uma cobrança separada por mensagem. (O preçário de mensagens do próprio WhatsApp altera-se 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 a sua própria Twilio). A regulaçã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 WhatsApp Business API e não altera o seu número de SMS.
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 a integridade dos números 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 ligou a sua própria chave Anthropic (BYOK), as mensagens de WhatsApp da Twilio gerida custam 0,05 créditos cada, de entrada e de saída. Em todas as outras contas, esses custos de entrega já estão cobertos pela sua taxa de crédito de IA, pelo que não existe uma cobrança separada por mensagem. 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 Anexar o seu remetente.
- 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 que consta no seu perfil de remetente 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 O seu Twilio (BYO), pronto a ser atribuído a uma campanha ou 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?
If you’re not sure whether switching is right for you, or run into trouble, contact support and we can help you decide.