Com o tipo de dados matriz, você pode tornar suas automações mais poderosas e cortar nós repetitivos nelas sem afetar a funcionalidade.
Neste artigo, você aprenderá a criar e modificar matrizes e verá alguns casos de uso reais. Observe que matrizes não estão disponíveis em ações de automação e só podem ser usadas via API. Este artigo abordará:
Criação de matrizes
As matrizes da Manychat podem conter textos e números. Existem duas maneiras de criar matrizes:
- Interface do usuário, diretamente no produto
- API
Para criar uma matriz via interface do usuário, siga estas etapas:
Navegue até Configurações → Campos:
Clique no botão + Novo campo de usuário. Adicione o nome do campo e selecione Matriz na lista suspensa. Em seguida, clique em Criar.
No momento, não é possível criar um campo bot com o tipo Matriz. Somente campos de usuário são aceitos.
Para criar uma matriz via API, use o ponto de extremidade /fb/page/createCustomField especifique array como o tipo no corpo da solicitação:
{
"caption": "Minha matriz",
"type": "array",
"description": "Este campo pode armazenar uma matriz"
}Leitura de matrizes
Os campos de usuário personalizados (CUFs) com o tipo matriz são acessíveis via:
- Interface do usuário, diretamente no produto
- API
Para obter a lista de CUFs, já existentes, navegue para Configurações → Campos. Todos os CUFs são mostrados em formato de tabela. Você pode verificar o tipo de um CUF na coluna "Tipo".
A mesma lista pode ser recuperada via ponto de extremidade /fb/page/getCustomFields.
Cada objeto CUF contém tipo:
Os valores de CUF associados a um contato específico estão armazenados em um cartão de contato. Por padrão, a Manychat mostra o número de elementos em um campo de matriz, mas você pode acessar todos os elementos da matriz clicando no campo. Exemplo:
O ponto de extremidade da API equivalente é /fb/subscriber/getInfo.
A resposta contém todos os CUFs com seu tipo e valor:
Modificação de matrizes
Modificar dados em CUFs com tipo array é possível via:
- Mapeamento de solicitação externa
- Mapeamento de ações de aplicativos
- API
Para mapear uma matriz, você deve especificar o caminho JSON para ela, e a Manychat salva essa matriz em um CUF. Abaixo, você pode encontrar um exemplo baseado em um serviço/API real.
Esta é uma resposta JSON da API de pedidos do Shopify. Cada pedido é único e pode conter um número diferente de itens. Usando matrizes, você pode salvar todas as unidades de manutenção de estoque (SKUs) em 1 CUF. Não há necessidade de analisar e preparar uma resposta para armazenar cada SKU em seu próprio CUF.
Os pontos de extremidade da API /fb/subscriber/setCustomField and /fb/subscriber/setCustomFields também podem ser usados para salvar matrizes. Alguns exemplos do corpo da solicitação são mostrados a seguir.
- definir valor não vazio
{
"subscriber_id": {{subscriber_id}},
"field_id": {{field_id}},
"field_value": [1, 2, 3, "maçãs"]
}- definir valor vazio
{
"subscriber_id": {{subscriber_id}},
"field_id": {{field_id}},
"field_value": []
}- limpar campo de matriz
{
"subscriber_id": {{subscriber_id}},
"field_id": {{field_id}},
"field_value": null
}Não é possível modificar ou limpar um campo de matriz na interface do usuário.
Casos de uso
As matrizes podem ser empregadas em vários casos de uso. O que as une é que os as matrizes são ótimas quando os dados com os quais você trabalha contêm um número desconhecido de elementos. Por exemplo:
- Comércio eletrônico. Cada carrinho e pedido são únicos. Os pedidos podem conter qualquer número de itens. Você pode assumir que um pedido médio contém 2 ou 3 itens e mapear cada item individualmente, mas, nesse caso, você poderá perder alguns dados se seu cliente pedir mais itens do que você previu no seu mapeamento.
- Bots baseados em NLU/NLP. Serviços como o wit.ai analisam a entrada do usuário e enviam de volta intenções e entidades. Novamente, cada entrada do usuário é única. Os arrays funcionam perfeitamente, não importa quantas entidades o serviço envie de volta.
- Perguntas de múltipla escolha. Se você usa formulários/pesquisas para qualificar seus contatos, talvez esteja familiarizado com perguntas de múltipla escolha. O número de opções que cada contato pode selecionar varia. É mais fácil armazená-los em matrizes do que analisar dados e criar um CUF separado para cada resposta.