Canais Somente Texto

Assim como o canal do Facebook, você configura canais somente de texto usando artefatos gerados pela plataforma de mensagens e pelo Digital Assistant. No entanto, para canais somente texto como Twilio/SMS, você também precisa atualizar a definição do fluxo de caixas de diálogo para permitir que as respostas do seu bot sejam renderizadas corretamente quando botões não forem suportados. Há dois aspectos disso:

Mostrando ou ocultando conteúdo para canais somente texto. Para componentes de Resposta Comum, isso significa que você precisa atualizar a propriedade metadata para incluir (ou, quando aplicável, excluir) o Twilio de qualquer item de resposta, cartão ou ação global:

responseItems:
- type: "text"
  text: "This text text displays on Twilio"
  visible:
    channels:
      include: "twilio"             
- type: "text"
  text: "This text is not shown in Twilio or Facebook!"
  visible:
    channels:
      exclude: "facebook, twilio"
  actions:
  - label: "This action is only shown on web channel."
    type: "postback"
    payload:
      action: "someAction"
    visible:
      channels:
        include: "web"

Configurando a numeração automática.

Twilio/SMS

Você precisará do seguinte para executar seu assistente digital no Twilio/SMS:

Credenciais do Twilio (você as fornece para a configuração do canal do Digital Assistant):
- Um número de telefone do Twilio
- SID da Conta
- Token de Autenticação
No Digital Assistant (e fornecido ao Twilio):
- O URL do webhook (gerado quando você cria o canal do Twilio).

Observação

Quando você criar um canal para um assistente digital no Twilio, lembre-se de que "sair", que os usuários podem usar para navegar para fora das habilidades do seu assistente digital, também é uma palavra-chave padrão no Twilio. Portanto, se um usuário digitar "sair" em um canal do Twilio, a conversa do Twilio será encerrada e o assistente digital não receberá essa entrada. Os usuários que desejam "sair" para trabalhar com o assistente digital precisariam entrar em contato com o Twilio e ter a palavra "sair" removida como palavra-chave de sua conta.

Etapa 1: Obter um Número do Twilo Ativado para SMS

Para gerar o Número, o SID da Conta e o Token de Autenticação do Twilio que são necessários para a configuração do canal do Twilio, primeiro crie uma conta do Twilio (caso ainda não tenha uma). Depois de verificar sua identidade:

Clique em Todos os Produtos e Serviços () na barra de navegação esquerda.
Fixe SMS Programável () e Números de Telefone () em seu painel de controle.

Descrição da ilustração twilio-products.png
Clique em Números de Telefone (agora fixado à barra de navegação esquerda) e, em seguida, clique em Conceitos Básicos.
Escolha Obter um Número ou Comprar um Número. Em qualquer um dos dois casos, certifique-se de selecionar a capacidade de SMS. Tenha esse número em mãos, porque você o usará para configurar o canal do Twilio novamente no Digital Assistant.
Clique em Painel de Controle da Console () na barra de navegação esquerda e anote o SID da Conta e o Token de Autenticação (que você acessa clicando em Exibir). Com o número do Twilio, você precisa dessas credenciais para configurar o Canal do Twilio.

Etapa 2: Vincular o Bot ao Número do Twilio

Com as credenciais do Twilio em mãos:

De volta ao Digital Assistant, clique em Canais no menu esquerdo e escolha Usuários.
Clique em Adicionar Canal.
Na caixa de diálogo Criar Canal:
1. Digite um nome e, em seguida, escolha Twilio SMS no menu Tipo de Canal.
2. Digite o SID da Conta, o Token de Autenticação e o Número do Twilio.
3. Ative a opção Canal Ativado.
4. Clique em e selecione o assistente digital ou a habilidade que deseja associar ao canal.
Clique em Criar. Anote o URL do Webhook. Você precisará dele para uma última parada na Console do Twilio.
Na Console do Twilio, clique em Números de Telefone (); em seguida, clique em Números Ativos.
Clique no número do Twilio na página Números Ativos.
Na Seção de Mensagens da página Configurar, cole o URL do Webhook no campo Uma Mensagem Chega.
Clique em Salvar.

Dicas de Teste

Você pode testar o Canal do Twilio usando seu próprio telefone, enviando mensagens ao número da conta do Twilio do Digital Assistant.

Capacidades Suportadas

Os Canais do Twilio no Digital Assistant suportam os seguintes recursos:

texto
imagens (como URL)
arquivos (como URL)
emojis (como URL)
links
postbacks (como URL)
propriedades personalizadas (parcial)
componentes de carrossel (parcial)
componentes de lista (parcial)

Observação

Se você estiver direcionando sua habilidade para vários canais com diferentes recursos de formatação, poderá usar a marcação HTML em suas mensagens. Para canais baseados em texto, essa marcação será removida da mensagem quando a mensagem for transmitida para o canal. Consulte Formatação de Rich Text em Canais.

Restrições de Mensagens

Os canais do Twilio no Digital Assistant têm as seguintes restrições de mensagens:

Mensagens de Texto
- Tamanho máximo da mensagem de texto: 1.600 caracteres. Se o tamanho exceder 1.600, o texto será dividido em várias mensagens.
- Tipos de ações de texto permitidos: Postback, Chamada, URL. Esses tipos de ação são convertidos em texto. Para ações de postback, o label serve como palavra-chave que pode ser usada para acionar o postback.
Cartões Horizontais
- Suportado?: Não, mas a funcionalidade equivalente mais próxima é obtida com a conversão de alguns tipos de ação em texto.
- Tipos de ações de cartão permitidos: Postback, Chamada, URL. Esses tipos de ação são convertidos em texto. Para ações de postback, o label serve como palavra-chave que pode ser usada para acionar o postback.
- Tipos de ações da lista de cartões permitidos: Postback, Chamada, URL. Esses tipos de ação são convertidos em texto. Para ações de postback, o label serve como palavra-chave que pode ser usada para acionar o postback.
Cartões Verticais
- Suportado: Não, mas a funcionalidade equivalente mais próxima é obtida com a conversão de alguns tipos de ação em texto.
- Tipos de ações de cartão permitidos: Postback, Chamada, URL. Esses tipos de ação são convertidos em texto. Para ações de postback, o label serve como palavra-chave que pode ser usada para acionar o postback.
- Tipos de ações da lista de cartões permitidos: Postback, Chamada, URL. Esses tipos de ação são convertidos em texto. Para ações de postback, o label serve como palavra-chave que pode ser usada para acionar o postback.
Mensagens de Anexo
- Suportado?: Sim, se MMS estiver ativado.
- Tipos de ações de anexo permitidos: Postback, Chamada, URL. Esses tipos de ação são convertidos em texto. Para ações de postback, o label serve como palavra-chave que pode ser usada para acionar o postback.
Botões de Ação
- Suportado? Não, mas a funcionalidade equivalente mais próxima é obtida com a conversão de alguns tipos de ação em texto.
- Tipos de ações globais permitidos: Postback, Chamada, URL. Esses tipos de ação são convertidos em texto. Para ações de postback, o label serve como palavra-chave que pode ser usada para acionar o postback.

Extensões de Canal do Twilio

Para canais do Twilio, você pode estender a funcionalidade dos componentes de Resposta Comum com recursos específicos do Twilio.

Acesse as extensões usando o elemento channelCustomProperties no componente e definindo as propriedades apropriadas. O código tem o seguinte formato:

...
            channelCustomProperties:
            - channel: "twilio"
              properties:
                PROPERTY_NAME: "PROPERTY_VALUE"
...

Você pode aplicar channelCustomProperties nos metadados do componente no nível de globalActions, responseItems e elementos de responseItems, dependendo da propriedade em questão.

Estas são as propriedades personalizadas disponíveis para canais do Twilio:

Nome	Valores permitidos	Aplica-se a...	Descrição
`mmsEnabled`	`true` `false`	Itens de resposta do tipo `cards` ou `attachment`.	Pode ser usado para substituir a definição padrão ativada para MMS da configuração de canal. Se ativado, as imagens serão mostradas em sua própria bolha de mensagem com um botão Toque para revisar.
`optimizeCardRendering`	`true` `false`	Itens de resposta do tipo `cards`.	Defina como `true` para tornar a seleção de ação do cartão um processo de duas etapas, no qual o usuário primeiro seleciona um cartão e depois seleciona a ação do cartão.
`cardListHeader`	texto livre	Itens de resposta do tipo `cards`.	O cabeçalho mostrado quando a lista de cartões é apresentada. Essa propriedade substitui a propriedade `headerText` da mensagem do cartão. Só é aplicável quando `optimizeCardRendering` é definido como `true`.
`cardListFooter`	texto livre	Itens de resposta do tipo `cards`.	O rodapé mostrado quando a lista de cartões é apresentada. Essa propriedade substitui a propriedade `footerText` da mensagem do cartão. Só é aplicável quando `optimizeCardRendering` é definido como `true`.
`cardDetailHeader`	texto livre	Qualquer um dos seguintes: Um cartão no qual a propriedade `"url"` é especificada Uma `action` em que `"type": "url"`	O cabeçalho mostrado quando o detalhe do cartão é apresentado. Essa propriedade substitui a propriedade `headerText` da mensagem do cartão. Só é aplicável quando `optimizeCardRendering` é definido como `true`.
`cardDetailFooter`	texto livre	Qualquer um dos seguintes: Um cartão no qual a propriedade `"url"` é especificada Uma `action` em que `"type": "url"`	O rodapé mostrado quando o detalhe do cartão é apresentado. Essa propriedade substitui a propriedade `footerText` da mensagem do cartão. Só é aplicável quando `optimizeCardRendering` é definido como `true`.

Para obter mais informações sobre como usar channelCustomProperties, consulte Extensões Específicas do Canal.

Documentação do Oracle Cloud Infrastructure