Passar para o conteúdo principal

Conectando Sua Conta Twilio com Awaz.ai

Awaz.ai integra-se diretamente com Twilio para usar seus números, gerenciar chamadas e enviar SMS facilmente na plataforma.

Por que integrar sua conta Twilio?

Ao conectar sua conta Twilio ao Awaz.ai, você desbloqueia várias vantagens importantes:

  • Números Locais: Dependendo do país onde você atua, Twilio permite usar números locais, o que melhora significativamente as conversões e a credibilidade do seu negócio.

  • Disponibilidade Global: Awaz.ai oferece números incorporados apenas para alguns países (EUA, Canadá, Singapura, Brasil, etc.). Com Twilio, essa limitação desaparece, e você pode comprar e usar números quase de qualquer país.

  • Maior Controle: Gerencie seus números, recursos SMS, conformidade regulatória e IDs de chamadas diretamente pelo painel Twilio, tendo controle total da sua estratégia de comunicação.


Como conectar Twilio ao Awaz.ai (Passo a passo)

Passo 1: Crie e Prepare sua Conta Twilio

Acesse o Twilio Console e crie uma nova conta ou faça login na sua conta existente.

Atualize sua Conta Twilio

Se você estiver usando uma conta nova ou de teste, atualize sua conta Twilio para uso em produção e adicione dados de cobrança válidos.

⚠️ Importante: Atualizar sua conta, adicionar uma forma de pagamento ou inserir saldo na sua conta Twilio não conclui a verificação de identidade e conformidade do Twilio.

Complete seu Primary Compliance Profile (KYC)

Você também deve concluir seu Primary Compliance Profile através do Trust Hub do Twilio. Este é o processo KYC (Know Your Customer) utilizado pelo Twilio para verificar a pessoa ou empresa responsável pela conta.

No seu Console Twilio, acesse:

Communications → Trust Hub → Profiles

Escolha o Primary Compliance Profile que se aplica ao seu caso:

  • Business – para empresas que podem fornecer documentação empresarial comprobatória.

  • Individual – para indivíduos ou empresários individuais que utilizam o Twilio sem documentação de uma empresa registrada.

Preencha as informações solicitadas pelo Twilio. Dependendo do tipo de perfil, estrutura empresarial e país, o Twilio poderá solicitar:

  • Informações pessoais ou do representante autorizado

  • Informações legais da empresa

  • Dados de registro da empresa

  • Endereço comercial

  • Documento de identificação emitido pelo governo

  • Documentos comprobatórios da empresa

  • Verificação de identidade

Depois de fornecer todas as informações necessárias, envie seu perfil para análise e siga quaisquer instruções adicionais exibidas no seu Console Twilio.

💡 Importante: O status de atualização/cobrança da sua conta e o Primary Compliance Profile são partes diferentes da preparação da sua conta Twilio. Ter uma forma de pagamento ativa ou saldo disponível não significa que a verificação da sua identidade ou empresa foi concluída.

💡 Dica: Certifique-se de que as informações enviadas correspondam aos seus documentos oficiais de identificação e da empresa. Diferenças em nomes, endereços ou informações de registro podem resultar em requisitos adicionais de verificação.


Passo 2: Compre ou transfira números telefônicos

No painel Twilio, vá para a seção “Phone Numbers”.
Clique em Buy a Number para escolher um número local ou internacional conforme sua necessidade.


Passo 3: Crie um Regulatory Bundle (se exigido pelo Twilio)

Dependendo do país, tipo de número e tipo de usuário final, o Twilio pode exigir informações regulatórias adicionais antes que você possa utilizar determinados números.

Esse processo é separado do Primary Compliance Profile concluído no Passo 1

  • No Console Twilio, vá para Phone Numbers > Regulatory Compliance.

  • Clique em Regulatory Bundles e depois em Create a Regulatory Bundle.

  • Selecione o país e o tipo do número (local, móvel, etc.).

  • Faça o upload da documentação solicitada (ex: registro comercial, documentos pessoais).

  • Envie o Regulatory Bundle para análise do Twilio.

💡 Importante: Os requisitos e o tempo de análise podem variar de acordo com o país e o tipo de número.


Passo 4: Verifique seu endereço comercial

Obrigatório em alguns países (ex: Nova Zelândia).

  • No Twilio Console, acesse Addresses (dentro de Phone Numbers > Regulatory Compliance).

  • Clique em Create a New Address e insira seu endereço comercial completo.

  • Siga as instruções para verificar o endereço (pode envolver código enviado por correio ou documentos adicionais).


Passo 5: Habilite permissões geográficas para voz no Twilio

Se tiver problemas para fazer chamadas, talvez seu Twilio esteja com restrições geográficas.

  • No Console, pesquise por “geo” para achar Voice Geographic Permissions.

  • Na seção “Elastic SIP Trunking”, habilite chamadas para os países/áreas necessárias marcando as caixas correspondentes.

  • Salve as alterações.

💡 Ativar essa permissão garante que seus agentes IA possam ligar para contatos globais sem interrupções.


Passo 6: Obtenha seu Account SID e Auth Token

Awaz.ai precisa dessas credenciais para se conectar ao Twilio.

Antes de conectar suas credenciais ao Awaz.ai, certifique-se de que sua conta Twilio esteja atualizada e que os requisitos de conformidade aplicáveis tenham sido concluídos.

  • No Console Twilio, encontre o Account SID no painel principal.

  • Clique no ícone de olho próximo ao campo Auth Token para revelar o token.

Se usar subconta Twilio:

  • Vá em Account > Subaccounts.

  • Clique no nome da subconta para encontrar Subaccount SID e Auth Token.

Importante: Mantenha seu Auth Token seguro e não compartilhe publicamente.


Passo 7: Conecte Twilio ao Awaz.ai

  • Faça login no Awaz.ai.

  • Vá em Settings > Integrations > Twilio.

  • Cole o Account SID (ou Subaccount SID) e Auth Token nos campos correspondentes.

  • Clique em Connect para finalizar.

Após a integração, seus números Twilio estarão disponíveis para uso no Awaz.ai.


Solução de Problemas Comuns

O Twilio Está Solicitando a Verificação da sua Identidade ou Empresa

Você pode já ter atualizado sua conta Twilio, adicionado dados de cobrança ou inserido saldo, mas o Twilio ainda está solicitando a verificação da sua identidade ou empresa.

Solução:

A cobrança e a verificação da conta são partes diferentes da configuração do Twilio.

Acesse:

Communications → Trust Hub → Profiles

Verifique seu Primary Compliance Profile e certifique-se de que todas as informações necessárias sobre sua identidade ou empresa tenham sido preenchidas e enviadas.

Se o Twilio solicitar informações ou documentos adicionais, siga as instruções exibidas no seu Console Twilio.

💡 Importante: Adicionar dados de cobrança ou saldo à sua conta Twilio não conclui automaticamente o processo de KYC ou a verificação de conformidade do Twilio.


O Twilio Exige um Regulatory Bundle para seu Número de Telefone

Ao tentar comprar ou transferir um número Twilio, você poderá receber uma mensagem informando que é necessário fornecer um Regulatory Bundle em conformidade com as regras do país e do tipo de número.

Solução:

Isso significa que o país ou tipo de número selecionado possui requisitos regulatórios adicionais.

  1. No Console Twilio, acesse Phone Numbers → Regulatory Compliance → Regulatory Bundles.

  2. Crie o Regulatory Bundle apropriado para o país e tipo de número.

  3. Forneça as informações do usuário final e os documentos comprobatórios solicitados.

  4. Verifique seu endereço, caso seja necessário.

  5. Envie o Regulatory Bundle para análise.

  6. Após a aprovação, siga as instruções do Twilio para associar o Bundle ou endereço apropriado ao seu número de telefone.

💡 Lembre-se: O Primary Compliance Profile e o Regulatory Bundle têm finalidades diferentes. Concluir seu Primary Compliance Profile não atende automaticamente aos requisitos regulatórios de todos os países ou tipos de números.


As Chamadas Não Conseguem Alcançar Determinados Países

Se o Twilio estiver conectado corretamente ao Awaz.ai, mas suas chamadas falharem para determinados países ou regiões, verifique suas Voice Geographic Permissions.

Acesse seu Console Twilio e revise os países habilitados em Voice Geographic Permissions, conforme explicado no Passo 5 deste guia.

Essas permissões determinam quais destinos sua conta Twilio pode chamar e são separadas das configurações do Trust Hub e dos requisitos regulatórios dos seus números.


Recursos Adicionais


Precisa de ajuda?

Temos muitos recursos para te apoiar!

📺 Vídeos Tutoriais: Assista a guias passo a passo
🔑 Login / Cadastro: Acesse o Awaz.ai
📖 Central de Ajuda: Visite nossa base de conhecimento
📧 E-mail de Suporte: [email protected]

👩‍💻 Ainda tem dúvidas? Nossa equipe de suporte está pronta para ajudar você!

Respondeu à sua pergunta?