API de armazenamento na Web e Cookies
No momento, você está lendo a documentação do Flex Legacy Messaging. Se você estiver começando com uma nova implementação do Flex, considere usar o Flex Conversations.
O Flex WebChat mantém alguns dados do lado do cliente para fornecer uma melhor experiência do usuário. Isso pode causar alguns problemas caso a API de armazenamento da Web dos seus clientes esteja desativada. Esta página aborda cookies, armazenamento local e de sessão e de que forma o Flex WebChat os utiliza.
Visão geral
O Flex WebChat utiliza cada estratégia de armazenamento das seguintes formas:
Cookies
O Flex WebChat não usa cookies. Caso os usuários bloqueiem o navegador de usar cookies, isso não deve causar nenhum problema.
Armazenamento local
Usado para manter o chat após o recarregamento da página e para o registro em log de erros. Desativar o armazenamento local prejudicará a experiência, principalmente ao atualizar a página, mas o WebChat ainda deve funcionar.
Armazenamento de sessão
Necessário para o funcionamento correto do WebChat (por ex., abrir e manter o WebSocket). Desativar o armazenamento de sessão impede que o WebChat funcione.
Definições
Tipo de armazenamento | String | Tamanho máximo | Expiração |
Cookies | Armazena dados que devem ser enviados de volta ao servidor com solicitações XHR subsequentes | 4KB | Expira em uma data de expiração escolhida ou, no caso de um cookie de sessão, ao término da sessão |
Armazenamento local | Armazena dados no navegador entre sessões. Abrir duas guias com o mesmo URL compartilhará o armazenamento local. Os dados nunca são enviados ao back‐end |
Até 5 MB de dados no navegador em pares chave/valor |
Os dados nunca expiram, mas podem ser apagados pelo usuário |
Armazenamento de sessão | Armazena temporariamente dados no navegador. Os dados não são mantidos entre as sessões (ou seja, duas guias com o mesmo URL terão armazenamento de sessão diferente). Os dados nunca são enviados ao back‐end. |
Armazena até 10 MB de dados no navegador em pares chave/valor |
Os dados expiram ao término da sessão; por ex., se a guia do navegador for fechada |
Informações armazenadas no armazenamento local
Chave/nome |
Valor |
Function |
Necessário para a funcionalidade do WebChat |
twilio-flex-cf |
Objeto |
Chave para o comportamento da IU no estado persistente nas recargas de página. Contém: |
Para uma melhor experiência de UX como manter o bate‐papo após recarregar, sim. Caso contrário, não. |
loglevel:twilio-flex-webchat-ui |
Enum |
Para depuração de flex-webchat-ui; determina o nível dos registros que serão impressos no console |
Não |
loglevel |
Enum |
Para depuração; determina o nível de registros que serão impressos no console |
Não |
Informações armazenadas no armazenamento da sessão no WebChat
Chave/nome |
Valor |
Function |
Necessário para a funcionalidade do WebChat |
twilio_twilsock_token_storage |
Booliano |
Indica o estado de inicialização do armazenamento de token de twilsock. |
Sim |
twilio_continuation_token_ip_messaging |
JWT |
Um token de continuação da conexão anterior no formato JSON Web Token permite que o cliente reutilize o mesmo ID do endpoint para mensagens |
Sim |
<id>::map::<id>.channels |
Objeto |
Contém dados de URI e ID para enviar/buscar informações de canal |
Sim |
<id>::map::<id>.info |
Objeto |
Contém dados de URI e ID para enviar/buscar informações de canal |
Sim |
<id>::document::<id>.channel |
Objeto |
Contém dados de URI e ID para enviar/buscar informações de canal |
Sim |
<id>::map::<id>.roster |
Objeto |
Contém dados de URI e ID para enviar/buscar informações de canal |
Sim |
<id>::list::<id>.messages |
Objeto |
Contém dados de URI e ID para enviar/buscar informações de mensagem |
Sim |
Precisa de ajuda?
Às vezes, todos nós precisamos; a programação é difícil. Receba ajuda agora da nossa equipe de suporte, ou confie na sabedoria da multidão navegando pelo Stack Overflow Collective da Twilio ou buscando a tag Twilio no Stack Overflow.