PABX/Twitter

• Antes de começar, é necessário ter uma conta de desenvolvimento ativa e verificada do Twitter.
  • Acesse: https://developer.twitter.com/ e faça o cadastro!
• Necessário instalar um certificado digital no PABX, pois as conexões DEVEM ser HTTPS. (Como instalar um certificado no PABX - Utilize o site https://www.sslforfree.com para criar um certificado e testar a conexão HTTPS.)
  • O PABX já possui integração com let's encryptt para certificados de 3 meses. Para gerar um certificado Let's Encrypt, acesse a interface WEB do APBX, menu CONFIGURAÇÕES ⇒ Gestão de Certificados. Clique na opção Adicionar e selecione a opção Utilizar Certbot.
• A API do Twitter só aceita como porta de acesso a porta 443. Necessário redirecionar para o PABX a porta 443.

Configurado Acesso a API do Twitter

• Acesse sua conta na plataforma https://developer.twitter.com/.
• Vá até o menu Projects and APPs e clique no botão + Create Project.

• Passo 1: Insira um nome para o projeto.

• Passo 2: Selecione o tipo do projeto - Building consumer tools (professional).

• Passo 3: Insira uma descrição para o projeto.

• Passo 4: Insira um nome para o Aplicativo e clique em Complete.

• Acesse novamente o menu Projects and APPs, selecione o novo APP criado. Vá até App permissions e clique no botão Edit.

• Na configuração de permissões do APP, selecione a opção 3 - Read + Write + Direct Messages.

Acesse novamente o menu Projects and APPs, selecione o novo APP criado. Vá até Authentication settings e clique no botão Edit.

• Na configuração de autenticação, configure conforme mostrado abaixo:

1. Habilite a opção Enable 3-legged OAuth
2. No campo Callback URLs, insira a URL de acesso ao PABX uTech / Twitter (DEVE ser HTTPS). Ex: htts://pbx.seudominio.com/twitter.
3. Em Website URL, insira a url para o site da empresa (Mesmo do domínio do campo CallBack URLs.
4. Demais campos Organization name, Organization URL, Terms of service e Privacy policy são opcionais.
5. Clique em Save.

PRONTO; Agora é necessário salvar as senhas e token's para configurar o PABX uTech. Acesse novamente o menu Projects and APPs, selecione o novo APP criado. Vá até Authentication settings e clique no botão Edit. Depois clique no botão Keys and Tokens, como mostrado abaixo:

• No campo Consumer Keys ⇒ API Key and Secret, clique no botão Regenerate. Depois no botão Yes, regenerate. Será mostrado as chaves da API. Copie e salve estes campos para configurar no PABX uTech, depois pressione o botão Yes, I saved it.

• Agora, vá até a opção Authentication Tokens &Arr; Access Token and Secret. clique no botão Regenerate. Depois no botão Yes, regenerate. Será mostrado os Tokens. Copie e salve estes campos para configurar no PABX uTech, depois pressione o botão Yes, I saved it.

Configurando PABX uTech

• Acesso o menu GESTÃO ⇒ Configuração. Selecione a aba Integrações e depois Twitter.
• Na tela inicial, insira uma senha no campo Token. Está senha é gerada pelo usuário para autenticação das requisições do twitter.
• Exemplo: qwertassdfgzxvcbghtdkjffhr

• Agora, é necessário inserir as contas do Twitter. Clique na aba Contas e depois Adicionar'.

• Nome da Aplicação: Insira o nome da aplicação criada no Twitter.
• Nome do Ambiente:: Insira uma descrição da conta.
• Conta: Este campo é o ID da conta do twitter. O campo será preenchido automaticamente ao salvar a conta (Caso todos os campos estiverem corretos).
• Chave da Aplicação: Este campo é o API Key, mostrado anteriormente nas configurações do twitter.
• Senha da Aplicação: Este campo é o API Secret Key, mostrado anteriormente nas configurações do twitter.
• Token de Acesso: Este campo é o Access Token, mostrado anteriormente nas configurações do twitter.
• Senha de Acesso: Este campo é o Access Token Secret, mostrado anteriormente nas configurações do twitter.
• Ramal, Fila, Mensagem Interativa, Chatbot e Consulta Número: Nessas opções, defina o destino das mensagem recebidas no twitter.

Ao clicar no botão salvar, o PABX uTech irá validar as senhas e tokens de acesso. Se estiver OK, a conta será salva. Caso contrário, será mostrado uma alerta com o erro retornado pelo Twitter e a conta NÃO SERÁ SALVA.