Monday, 7 June, 2021 UTC


Summary

Com o anúncio recente da API da Twilio para WhatsApp e o entusiasmo em relação ao Twilio Flex, acredito que seria divertido trazer o WhatsApp para o espaço do contact center. Com apenas alguns minutos de configuração, os clientes podem atingir seus negócios por meio de um canal totalmente diferente. Vejamos como as mais recentes novidades da Twilio funcionam perfeitamente em conjunto!
Requisitos
Se quiser acompanhar e trazer o WhatsApp para o Flex, é preciso:
  • Uma conta Twilio (cadastre-se gratuitamente aqui para ter uma conta Twilio)
  • Um projeto com o Twilio Flex (comece aqui)
  • O WhatsApp Sandbox Channel. Siga as instruções para instalar o WhatsApp Sandbox Channel em sua conta. Você também precisa conectar sua própria conta do WhatsApp com o sandbox
Vamos começar!
Comece com o Flex
Se já configurou sua instância do Flex, pode prosseguir para a próxima etapa.
Se for novo no Flex, crie uma nova conta do Flex. Siga as instruções para iniciar a configuração do Flex. Durante esse processo, diversos serviços da Twilio serão criados para você.
Abra a UI do Flex em seu navegador e aparece:

Como criar um URL de manipulador de mensagens
O formato do URL de seu manipulador de mensagens deve ser:
https://webhooks.twilio.com/v1/Accounts/ACxx/Proxy/KSxx/Webhooks/Message 
Substitua ACxx pelo Account SID (SID da conta) (encontrado no dashboard da conta) e KSxx pelo Flex Proxy Service SID (SID do serviço Proxy Flex) (encontrado na página Services (Serviços)). Este será o URL do seu manipulador de mensagens.
Como configurar o WhatsApp Sandbox
Navegue até o WhatsApp Sandbox. (Se ainda não configurou a sandbox, faça isso agora!) Vá para a seção Sandbox Configuration (Configuração do sandbox) e cole o URL do manipulador de mensagens no campo de texto "When A Message Comes In" (Quando uma mensagem é recebida). Salve as configurações da sandbox.
Como reunir alguns detalhes da conta
Ainda em WhatsApp Sandbox, salve seu número do WhatsApp para mais tarde.

Navegue até o Studio e localize o fluxo de mensagens do Flex. Salve o Flow SID (SID do fluxo), que começa com FWxx.

No Programmable Chat (Chat programável), pegue o Instance SID (SID da instância) do serviço de chat, que começa com ISxx.


Por fim, pegue seu Auth Token (token de autenticação) para que possamos fazer uma solicitação de API à Twilio. O Auth Token (token de autenticação) é um valor oculto encontrado no painel de sua conta do Flex.

Como vincular seu WhatsApp a um fluxo do Studio
Por fim, inicie uma sessão de shell de comando e execute a seguinte solicitação curl:
curl -X POST "https://flex-api.twilio.com/v1/FlexFlows" \ --data-urlencode "ChannelType=whatsapp" \ --data-urlencode "Enabled=true" \ --data-urlencode "IntegrationType=studio" \ --data-urlencode "ContactIdentity=whatsapp:+xxxx" \ --data-urlencode "FriendlyName=Flex WhatsApp FlexFlow" \ --data-urlencode "Integration.FlowSid=FWxx" \ --data-urlencode "ChatServiceSid=ISxx" \ -u ACxx:yourAuthToken 
Substitua os valores acima por:
  • Número do WhatsApp (em ContactIdentity) no formato E.164
  • Flow SID (SID do fluxo) do Studio (em Integration.FlowSid)
  • Instance SID (SID da instância) do serviço de chat
  • Account SID (SID da conta)
  • Auth Token (Token de autenticação)

Exemplo de resposta de API de fluxos do Flex

{ "integration": { "retry_count": 3, "flow_sid": "FWda89b731a3cce381b3c37c69e0cd1013" }, "janitor_enabled": false, "integration_type": "studio", "date_updated": "2020-11-10T23:20:30Z", "enabled": true, "friendly_name": "Flex WhatsApp FlexFlow", "contact_identity": "whatsapp:+14155238886", "account_sid": "ACxx", "channel_type": "whatsapp", "url": "https://flex-api.twilio.com/v1/FlexFlows/FOb939520aee88d161ae0f750db8ead4b9", "sid": "FOb939520aee88d161ae0f750db8ead4b9", "date_created": "2020-11-10T23:20:30Z", "long_lived": false, "chat_service_sid": "IS75c3668972364ff28a4d7ad06f0e6073" } 
É possível gerenciar suas mensagens com muito mais do que apenas o Studio. Saiba mais na documentação sobre Mensagens no Flex. Para obter mais detalhes sobre as propriedades do Flex Flow, consulte a página de referência da API.
Comece a conversar
Você está pronto para flexionar os músculos do WhatsApp! Defina como disponível na UI do Flex, envie uma mensagem de WhatsApp para o número do sandbox e veja-a aparecer como uma nova tarefa no Flex!

Aceite a tarefa e comece a conversar! Seu contact center agora pode receber chats do WhatsApp e responder a eles como SMS, chat da Twilio ou mensagens do Facebook Messenger.
Continue exercitando esses músculos
Agora que você adicionou essa integração de canal rápido ao Flex, tente adicionar outro canal de mensagens. Também é possível personalizar o Flex estilizando a UI para refletir sua marca ou criando componentes personalizados para ampliar o que é possível fazer com o Twilio Flex.
Pronto para ampliar a API da Twilio para WhatsApp? Experimente nosso aplicativo de tradução de emojis ou nosso bot de pesquisa npm ou crie seu próprio hack exclusivo do WhatsApp!

Mal podemos esperar para ver o que você vai construir!
Este artigo foi traduzido do original "Twilio WhatsApp API and Flex in Minutes". Enquanto melhoramos nossos processos de tradução, adoraríamos receber seus comentários em [email protected] - contribuições valiosas podem render brindes da Twilio.