As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá. # Configurar mensagens WhatsApp comerciais Os tópicos desta seção explicam como configurar e testar o sistema de mensagens WhatsApp corporativas para o Amazon Connect. Você usa o [AWS End User Messaging Social](https://docs.aws.amazon.com/social-messaging/latest/userguide/what-is-service.html) para vincular uma conta WhatsApp comercial e um número de telefone a uma instância do Amazon Connect e, em seguida, importa o número de telefone vinculado para o Amazon Connect. Os clientes podem então usar WhatsApp para enviar mensagens para sua central de atendimento. Você também pode usar o Amazon Lex para automatizar as respostas às perguntas dos clientes, o que economiza tempo e esforço dos atendentes. Para acessar mais informações, consulte [Conceitos básicos do Amazon Lex](https://docs.aws.amazon.com/lexv2/latest/dg/getting-started.html) no *Guia do desenvolvedor do Amazon Lex*. **Topics** + [Pré-requisitos](#whatsapp-prerequisites) + [Etapa 1: habilitar o Amazon Connect como destino do evento](#enable-connect-destination) + [Etapa 2: configurar um fluxo de contato de entrada em seu número de telefone](#inbound-contact-flow) + [Etapa 3: enviar e receber mensagens de teste](#send-receive-test-messages) + [Próximas etapas: prepare-se para a produção](#whatsapp-next-steps) + [Solucionar problemas comuns](#whatsapp-troubleshooting) + [WhatsApp Capacidades e limitações de mensagens comerciais com o Amazon Connect](whatsapp-messaging-capabilities.md) ## Pré-requisitos Antes de fazer a integração WhatsApp com o Amazon Connect, você deve ter os seguintes itens: + Uma conta WhatsApp comercial. + Um número WhatsApp de telefone. O número deve ser capaz de receber uma chamada de voz ou uma mensagem de texto SMS para concluir o processo de verificação do número de telefone da Meta para mensagens WhatsApp comerciais. Você pode usar um número de voz do Amazon Connect ou um AWS End User Messaging SMS número para o número de WhatsApp telefone. Você também pode usar um número de telefone de sua propriedade externa AWS. Ao usar um número ou AWS End User Messaging SMS número de voz do Amazon Connect, recomendamos solicitar um novo número que não seja usado com tráfego de voz ou SMS ao vivo para evitar possíveis interrupções no serviço. Você pode usar o console social do AWS End User Messaging em [https://console.aws.amazon.com/social-messaging/](https://console.aws.amazon.com/social-messaging/)para criar a conta WhatsApp comercial e o número de telefone. Para obter mais informações, consulte [Inscrever-se WhatsApp](https://docs.aws.amazon.com/social-messaging/latest/userguide/getting-started.html#getting-started-embedded) no *Guia do usuário social do AWS End User Messaging*. **Importante** WhatsApp tem um processo automatizado de verificação comercial que pode levar até duas semanas para ser concluído. Recomendamos que você inicie esse processo mais cedo. WhatsApp pode desativar contas WhatsApp comerciais se a política WhatsApp comercial for violada ou se a identidade comercial não puder ser verificada. Além disso, é altamente recomendável revisar [as melhores práticas de mensagens sociais e as [WhatsApp melhores práticas](https://business.whatsapp.com/policy#best_practices) sociais de mensagens para usuários finais da AWS](https://docs.aws.amazon.com/social-messaging/latest/userguide/best-practices.html) antes de criar e vincular recursos WhatsApp . Depois de criar a conta e o número de telefone, conclua as etapas nas seções a seguir na ordem listada. ## Etapa 1: habilitar o Amazon Connect como destino do evento As etapas a seguir explicam como usar o AWS End User Messaging Social para habilitar o Amazon Connect como destino do evento para sua conta WhatsApp comercial vinculada. Isso permite que o sistema importe seu número de WhatsApp telefone. Você pode usar o [console social AWS End User Messaging](https://console.aws.amazon.com/social-messaging/) ou o AWS CLI para concluir essa tarefa. Para usar o AWS CLI, consulte [https://docs.aws.amazon.com/connect/latest/APIReference/API_ImportPhoneNumber.html](https://docs.aws.amazon.com/connect/latest/APIReference/API_ImportPhoneNumber.html)na Referência da *API do Amazon Connect e [https://docs.aws.amazon.com/social-messaging/latest/APIReference/API_PutWhatsAppBusinessAccountEventDestinations.html](https://docs.aws.amazon.com/social-messaging/latest/APIReference/API_PutWhatsAppBusinessAccountEventDestinations.html)na Referência* da *API social de mensagens para usuários AWS finais*. As etapas a seguir explicam como usar o console. **Para usar o console do** 1. Faça login no console social do AWS End User Messaging em [https://console.aws.amazon.com/social-messaging/](https://console.aws.amazon.com/social-messaging/). 1. No painel de navegação, escolha **Contas WhatsApp comerciais** e, em seguida, escolha a conta desejada. 1. Na guia **Destino do evento**, escolha **Editar destino**. 1. Em **Tipo de destino**, escolha **Amazon Connect**. 1. Em **Instância do Connect**, escolha sua instância do Amazon Connect na lista suspensa. 1. Em **ARN do perfil**, escolha um perfil do IAM que conceda permissão para entregar mensagens e eventos e importar números de telefone. Por exemplo, políticas do IAM, consulte [Add a message and event destination to AWS End User Messaging Social](https://docs.aws.amazon.com/social-messaging/latest/userguide/managing-event-destinations-add.html#managing-event-destinations-amazon-connect-policies) no *Guia do usuário do AWS User Messaging Social*.  1. Escolha **Salvar alterações**. Isso inicia o processo de importação do número de telefone para o Amazon Connect. Após a conclusão da operação, o número aparecerá no site de administração do Amazon Connect. **Como visualizar o número** + No menu de navegação, escolha **Canais**, depois, **Números de telefone**. A coluna **Canais ativos** é exibida **WhatsApp**para todos os WhatsApp números. ![\[A página de números de telefone mostrando um WhatsApp número.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/whats-app-imported-number.png) ## Etapa 2: configurar um fluxo de contato de entrada em seu número de telefone Você pode criar um fluxo de contato de entrada para usar com seu número de WhatsApp telefone ou pode reutilizar um fluxo existente. Se você reutilizar um fluxo, poderá adicionar um bloco `CheckContactAttribute` e habilitar a ramificação do fluxo. O bloco permite que você envie WhatsApp contatos para uma fila específica ou execute outra ação. Para acessar mais informações sobre como criar seu fluxo de contatos, incluindo mensagens interativas e visualizações de links avançados, consulte [WhatsApp Capacidades e limitações de mensagens comerciais com o Amazon Connect](whatsapp-messaging-capabilities.md) mais adiante nesta seção. Os conjuntos de etapas a seguir explicam como configurar um fluxo de contato de entrada e adicionar um bloco `CheckContactAttribute` ao fluxo. **Como configurar um fluxo** 1. Inicie o console do Amazon Connect em [https://console.aws.amazon.com/connect/](https://console.aws.amazon.com/connect/) 1. No menu de navegação, escolha **Canais**, depois, **Números de telefone**. 1. Escolha o WhatsApp número e, em seguida, escolha **Editar**. 1. Em **Fluxo/IVR**, escolha o fluxo que você atualizou. ![\[A seção Fluxo de contato/IVR da página Editar mostrando um WhatsApp fluxo.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/whatsapp-flow-ivr.png) 1. Escolha **Salvar**. **Como adicionar o bloco CheckContactAttribute** 1. Siga as etapas 1 a 4 [da seção anterior](#enable-connect-destination). 1. Abra a página **Propriedades** do fluxo. 1. Na seção **Atributos para verificar**, defina **Namespace** como **Atributos de segmentos** e **chave** como **Subtipo**. Para acessar mais informações sobre atributos de segmento, consulte [SegmentAttributes](ctr-data-model.md#segmentattributes) mais adiante neste guia. 1. Na seção **Condições para verificar**, defina a **condição** como **Igual** e o **valor** para **conectar**:. WhatsApp 1. Escolha **Salvar**. ## Etapa 3: enviar e receber mensagens de teste Nesta etapa, você usa o Painel de Controle de Contato (CCP) e um telefone celular para enviar e receber mensagens de WhatsApp teste. **Como testar a integração** 1. No CCP, defina o status como **Disponível**. 1. Usando WhatsApp no seu celular, inicie uma conversa digitando o número de telefone que você adicionou anteriormente. A imagem a seguir mostra uma mensagem com **Opções** e a lista de opções resultante. ![\[Tela do celular mostrando uma mensagem de exemplo.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/whatsapp-options-results.png) ## Próximas etapas: prepare-se para a produção Depois de testar sua integração, recomendamos adicionar os seguintes recursos e capacidades ao seu canal WhatsApp de mensagens. ### Adicionar recursos do Amazon Connect Os links na lista a seguir levam você para informações sobre os recursos do Amazon Connect que você pode adicionar às suas experiências de clientes e atendentes. + Saiba mais sobre o [WhatsApp Capacidades e limitações de mensagens comerciais com o Amazon Connect](whatsapp-messaging-capabilities.md). + [Permitir que os clientes retomem conversas de chat no Amazon Connect](chat-persistence.md): os clientes podem retomar conversas anteriores com o contexto, os metadados e as transcrições transferidos. Eles não precisam se repetir quando retornam ao chat, e os atendentes têm acesso a todo o histórico de conversas. + [Criar respostas rápidas a serem usadas com contatos de chat e e-mail no Amazon Connect](create-quick-responses.md): dê aos atendentes respostas pré-escritas para perguntas de cliente comuns que eles possam usar enquanto conversam com eles. Respostas rápidas agilizam a resposta dos atendentes para os clientes. ### Adicionar pontos de entrada Os links na lista a seguir levam você para informações sobre como adicionar diferentes tipos de pontos de entrada de clientes. + Pontos de entrada: [5 maneiras de direcionar leads e clientes para conversas de mensagens comerciais](https://business.whatsapp.com/blog/messaging-app-entry-points) (postagem WhatsApp no blog) + Códigos QR: [gerencie o código QR da sua plataforma de WhatsApp negócios](https://business.facebook.com/business/help/890732351439459) (artigo de ajuda do Meta) + Click-to-WhatsAppanúncios: [crie anúncios que cliquem no Gerenciador de anúncios](https://business.facebook.com/business/help/447934475640650?id=371525583593535) (artigo de ajuda do Meta) WhatsApp ### Adicionar um nome de exibição ao seu número de telefone Para adicionar um nome de exibição verificado que os clientes vejam, [o nome WhatsApp de exibição Sobre a empresa](https://business.facebook.com/business/help/338047025165344) na ajuda do Meta. ### Escalar o tráfego Depois de integrar o tráfego ao vivo à sua WhatsApp integração, recomendamos monitorar as cotas a seguir. **Cotas do Amazon Connect** Para acessar mais informações sobre cotas padrão e sobre como aumentá-las, consulte [Amazon Connect cotas de serviço](amazon-connect-service-limits.md). + Cota de [chats ativos simultâneos por instância](amazon-connect-service-limits.md#concurrent-active-chats). Para acessar informações sobre o monitoramento dessa cota, consulte [Monitorando sua instância do Amazon Connect usando CloudWatch](monitoring-cloudwatch.md). + Cotas de controle de utilização do [StartChatContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartChatContact.html). + Cotas de controle de utilização do [SendChatIntegrationEvent](https://docs.aws.amazon.com/connect/latest/APIReference/API_SendChatIntegrationEvent.html). + Cotas de controle de utilização do `SendIntegrationEvent`. Uma API somente com permissão usada pelo AWS End User Messaging Social para publicar WhatsApp eventos de entrada. **Cotas do End User Messaging Social** O AWS End User Messaging Social impõe limites de taxa em várias mensagens APIs. Monitore o seguinte APIs para ver se você precisa alterar uma ou mais cotas. Os links levam você para a *Referência de API do AWS End User Messaging Social*. + [SendWhatsAppMessage](https://docs.aws.amazon.com/social-messaging/latest/APIReference/API_SendWhatsAppMessage.html) + [PostWhatsAppMessageMedia](https://docs.aws.amazon.com/social-messaging/latest/APIReference/API_PostWhatsAppMessageMedia.html) + [GetWhatsAppMessageMedia](https://docs.aws.amazon.com/social-messaging/latest/APIReference/API_GetWhatsAppMessageMedia.html) Para acessar mais informações sobre como aumentar as cotas do AWS End User Messaging Social, consulte os tópicos a seguir no *Guia do usuário do AWS End User Messaging Social:*: + [Quotas for AWS End User Messaging Social](https://docs.aws.amazon.com/social-messaging/latest/userguide/quotas.html) + [Aumente os limites de conversação de mensagens em WhatsApp](https://docs.aws.amazon.com/social-messaging/latest/userguide/increase-message-limit.html) + [Aumente a taxa de transferência de mensagens em WhatsApp](https://docs.aws.amazon.com/social-messaging/latest/userguide/increase-message-throughput.html) ## Solucionar problemas comuns Use as informações a seguir para solucionar problemas comuns com uma WhatsApp integração. **Topics** + [Não é possível ver os números de telefone importados na sua instância do Amazon Connect](#no-imported-number) + [As mensagens de entrada dos clientes não são entregues](#whatsapp-messages-not-delivered) ### Não é possível ver os números de telefone importados na sua instância do Amazon Connect Se o número importado não aparecer no site de administração do Amazon Connect, siga estas etapas: + Verifique se o perfil do IAM de destino do evento tem as permissões necessárias. Para obter mais informações, consulte [Etapa 1: habilitar o Amazon Connect como destino do evento](#enable-connect-destination). + Veja se sua cota de *números de telefone por instância* precisa ser aumentada. Para obter mais informações, consulte [Amazon Connect cotas de serviço](amazon-connect-service-limits.md). + Para reatribuir uma conta WhatsApp comercial vinculada a uma instância diferente do Amazon Connect, você deve primeiro liberar os números de telefone importados da instância original do Amazon Connect. Depois que os números de telefone forem liberados, você poderá atualizar o destino do evento na sua conta WhatsApp comercial vinculada para outra instância do Amazon Connect. **Importante** Não divulgue números que lidem com o tráfego de clientes ao vivo. Em vez disso, [reivindique novos números de telefone](https://docs.aws.amazon.com/connect/latest/adminguide/claim-and-manage-phonenumbers.html). + Para ajudar a determinar a causa do problema de importação, pesquise `ImportPhoneNumber` eventos em seus CloudTrail registros e verifique os detalhes do erro. Se a chamada `ImportPhoneNumber` for bem-sucedida, você poderá chamar `DescribePhoneNumber` para saber outros detalhes do erro. Se você fez uma correção, deverá importar os números de telefone novamente. Para fazer isso, repita [Etapa 1: habilitar o Amazon Connect como destino do evento](#enable-connect-destination). ### As mensagens de entrada dos clientes não são entregues Se a entrega da mensagem de WhatsApp entrada parar, pesquise AWS CloudTrail `SendIntegrationEvent` nos registros os detalhes do erro. `SendChatIntegrationEvent` Você também pode conferir esses cenários comuns: + Certifique-se de que sua conta WhatsApp comercial vinculada no AWS End User Messaging Social tenha um destino de evento do Amazon Connect habilitado. + Verifique se o perfil do IAM de destino do evento tem as permissões necessárias. Para acessar mais informações, consulte [Etapa 1: habilitar o Amazon Connect como destino do evento](#enable-connect-destination) anteriormente nesta seção. Você tem uma função mal configurada que CloudTrail gera `AccessDeniedException` erros da `SendIntegrationEvent` API. + Certifique-se de que seu número de WhatsApp telefone tenha sido importado com sucesso para sua instância do Amazon Connect e que o número tenha um fluxo de contato de entrada associado. Para obter mais informações, consulte [Etapa 2: configurar um fluxo de contato de entrada em seu número de telefone](#inbound-contact-flow). + As mensagens de entrada foram descartadas porque ainda não são aceitas. Para obter mais informações, consulte [WhatsApp Capacidades e limitações de mensagens comerciais com o Amazon Connect](whatsapp-messaging-capabilities.md). # WhatsApp Capacidades e limitações de mensagens comerciais com o Amazon Connect A integração de mensagens WhatsApp corporativas fornece os seguintes recursos: + Mensagens de texto + Mensagens interativas. Para obter mais informações, consulte [Adicionar mensagens interativas do Amazon Lex para clientes no chat](interactive-messages.md). + Mensagens com visualizações de links avançados + Recebimentos entregues e lidos para mensagens comerciais + Anexos ## Limitações Ao integrar o sistema WhatsApp de mensagens corporativas com o Amazon Connect, esteja ciente das seguintes limitações: **Limitações de recebimento de entrega** + Recebimentos de leitura para mensagens de clientes não são aceitos. + Recebimentos de entrega para mensagens de clientes não são aceitos. Os recibos de entrega que aparecem em WhatsApp indicam que você WhatsApp recebeu a mensagem, não o Amazon Connect. **Limitações de mensagens de texto** + Mensagens de texto de entrada de clientes com mais de 1.024 caracteres não são aceitas. **Tipos de mensagens não aceitos** + Mensagens de contato de entrada enviadas por clientes não são aceitas. + Mensagens de local de entrada enviadas por clientes não são aceitas. + Mensagens de reação enviadas pelos clientes não são aceitas. + Mensagens de resposta enviadas pelos clientes não são aceitas. Novo conteúdo de mensagens é entregue sem o contexto da resposta. + O recebimento de status de mensagem informando que uma mensagem foi excluída pelo cliente não é aceito. **Limitações do anexo** + Os anexos de clientes ao iniciar um novo contato ou conversa não são aceitos. Os clientes só podem enviar anexos durante um contato existente. + Anexos de clientes com mais de 20 MB não são aceitos. + Anexos com legendas não são aceitos. O Amazon Connect remove todas as legendas e entrega o anexo. + Anexos de adesivos não são aceitos.