LogoLogo
Zenvia Docs
  • Zenvia NLU
  • Boas Práticas
    • Eventos
      • Dicas para criar eventos
      • Eventos Personalizados
        • menu_principal
          • Dashboard
          • Fluxograma
          • Builder
          • Lista de Eventos
        • Autosservico
          • Dashboard
          • Fluxograma
          • Builder
          • Lista de eventos
        • sucess_no_friccion
          • Dashboard
          • Fluxograma
          • Builder
          • Lista de Eventos
        • horario_atendimento
          • Dashboard
          • Fluxograma
          • Builder
          • Lista de eventos
        • transbordo
          • Dashboard
          • Fluxograma
          • Builder
          • Lista de eventos
        • pesquisa_satisfacao
          • Dashboard
          • Fluxograma
          • Builder
          • Lista de eventos
        • conseguiu_ajudar
          • Dashboard
          • Fluxograma
          • Builder
          • Lista de eventos
        • nivel_confianca
          • Dashboard
          • Fluxograma
          • Builder
          • Lista de eventos
        • chamada_api
          • Dashboard
          • Fluxograma
          • Builder
          • Lista de Eventos
        • falha_api
          • Dashboard
          • Fluxograma
          • Builder
          • Lista de Eventos
        • primeiro_acesso
          • Dashboard
          • Fluxograma
          • Builder
          • Lista de Eventos
        • encerramento
          • Dashboard
          • Fluxograma
          • Builder
          • Lista de Eventos
        • estouro_tentativas_else
          • Dashboard
          • Fluxograma
          • Builder
          • Lista de Eventos
        • intents
          • Dashboard
          • Fluxograma
          • Builder
          • Lista de Eventos
        • rechamada
          • Dashboard
          • Fluxograma
          • Builder
          • Lista de Eventos
    • Gestão de NLU
      • Dicas de gestão de NLU
    • Personalizar widget
  • Monitor
    • Dashboard
      • Métricas e indicadores
      • Gráficos
    • Atendimentos
    • Eventos
    • Volumetria
    • Issues
    • Monitoramento de APIs
    • Métricas de avaliação
  • Build
    • Assistentes
      • Edição do Assistente
      • Builder
        • Configurações do nó
        • Componentes
          • Output
            • Texto
            • Texto randômico
            • Texto sequencial
            • Base de conhecimento
            • LivePerson - Conteúdo Estruturado
            • Arquivo
          • Input
            • Pergunta aberta
            • Autocomplete
            • Data
            • Feedback NPS
            • Feedback Custom
            • Lista inline
            • Lista modal
            • Quick Replies
            • Upload de arquivo
            • Upload de arquivo LP
            • Carrossel de Opções
            • Desambiguação
          • Fluxo de Inatividade
          • Variáveis
          • Ações
            • HTTP Request
            • Satisfaction
            • Validar celular
            • Validar CEP
            • Validar CPF
            • Validar CPF/CNPJ
            • Validar CNPJ
            • Validar nome completo
            • Validar e-mail
            • Procurar atendimento
            • Transferência entre skills Liveperson
            • Setar contexto LivePerson
            • Encerrar Atendimento LivePerson
            • Encerrar chat
            • Socket Event
            • Facebook Profile
            • Facebook Transbordo
            • Workplace Profile
            • Iniciar LiveChat
            • Functions
            • Setar NLU
            • Transferência entre assistentes
            • Contact Return
            • Intent Feedback
          • Eventos
    • Functions
    • Atributos
  • CONNECT
    • APIs
      • Agent connector API
      • Outbound
        • Outbound WhatsApp
        • Outbound Zenvia
        • Outbound Wavy
        • Outbound LivePerson
        • Outbound Infobip
        • Outbound RCS
      • Eventos
      • Atendimentos
      • LGPD
    • Canais
      • Capabilities
      • Instagram
      • Google Business Messages
      • Bot API
      • Facebook
        • Integração Messenger via Zenvia NLU
        • Integração Messenger via Liveperson
      • Google RCS
      • Microsoft Teams
      • Whatsapp
        • Zenvia
        • Blip
        • Wavy
        • Infobip
        • Liveperson
      • Widget
      • Workplace
    • Telegram
    • Contingência
    • LiveChat
      • Transbordo ALTU Connector API
        • Transbordo Tech4Humans
      • Transbordo LivePerson
      • Transbordo Zendesk Ticket
      • Transbordo Zendesk Chat
      • Transbordo Salesforce
  • TRAIN
    • Primeiros passos
    • Visão Geral
    • Configuração do NLU
    • Avaliação de Mensagens
    • Análise e ajustes
  • Mais
    • Release
      • Controle de Versão
      • 27/10/2021
      • 06/10/2021
      • 22/09/2021
      • 09/09/2021
      • 11/08/2021
      • 28/07/2021
      • 14/07/2021
      • 30/06/2021
      • 16/06/2021
      • 01/06/2021
      • 18/05/2021
      • 04/05/2021
      • 20/04/2021
      • 06/04/2021
      • 23/03/2021
      • 09/03/2021
      • 23/02/2021
      • 09/02/2021
      • 26/01/2021
      • 12/01/2021
      • 22/12/2020
      • 08/12/2020
      • 24/11/2020
      • 10/11/2020
      • 27/10/2020
      • 13/10/2020
      • 29/09/2020
      • 15/09/2020
      • 01/09/2020
      • 18/08/2020
      • 03/08/2020
      • 21/07/2020
      • 08/07/2020
      • 30/06/2020
      • 04/06/2020
      • 22/05/2020
      • 14/05/2020
      • 29/04/2020
      • 01/04/2020
      • 24/03/2020
      • 16/03/2020
    • Glossário
Powered by GitBook
On this page
  • Estrutura
  • Atributos:
  • Exemplos
  • Compatibilidades:
  • Stickers
  • Multiplos arquivos
  • Estrutura:

Was this helpful?

  1. Build
  2. Assistentes
  3. Builder
  4. Componentes
  5. Output

Arquivo

O componente de output Arquivo permite o envio de imagens ou documentos. Utilize quando tiver uma URL pública ou o id de mídia do arquivo hospedado no WhatsApp.

Embora alguns parâmetros não sejam obrigatórios, procure preencher o máximo de informações possíveis sobre o arquivo que estiver enviando. As informações extras serão utilizadas para exibir detalhes sobre o arquivo no histórico de mensagens em Atendimento.

Disponível nos canais Liveperson, WhatsApp e Widget

Estrutura

[
    {
        "<channel>": {
            "type": "file",
            "file": {
                "url": "<url http ou https do arquivo>",
                "whatsapp_media_id": "<id do arquivo WhatsApp>",
                "type": "<tipo do arquivo>",
                "name": "<nome do arquivo>",
                "caption": "<descrição do arquivo - não é possível adicionar formatação>",
                "size": "<tamanho do arquivo em bytes>",
                "payload": {
                    "delay": 2000
                }
            }
        }
    }
]

Atributos:

Nome

Obrigatório

Descrição

channel

Sim

Opções: default, Apple, Facebook, Whatsapp ou Widget. Especifica o canal que deverá receber o arquivo. Quando channel for default, todos os canais com suporte poderão receber o arquivo. Quando definir um canal específico, apenas este canal receberá o arquivo.

url

Sim, quando enviado para um canal diferente de whatsapp do Facebook

A URL pública e válida do arquivo. Quando channel for whatsapp, certifique-se que a URL seja HTTP ou HTTPS.

whatsapp_media_id

Sim, quando enviar ao canal whatsapp do Facebook e url não for definido

type

Sim

Extensão do arquivo. Por exemplo "JPEG", "PNG", "PDF", "DOCX", e etc.(Caso queira enviar vários tipos de arquivo, utilize "application/*").

name

Sim, quando channel for default ou liveperson

O nome do arquivo.

caption

Não

Descrição do arquivo.

size

Sim, quando channel for liveperson

Tamanho do arquivo em kilobytes.

delay

Não

Tempo (milissegundos) de atraso antes da próxima opção aparecer. Sendo de 0 á 5000, se for inserido um valor acima de 5000 o delay é descartado.

Exemplos

O output de arquivo a seguir é utilizado para enviar um arquivo acessível através de uma URL pública. A imagem será entregue ao usuário através do canal Whatsapp de origem Facebook ou Liveperson.

[
    {
        "whatsapp": {
            "type": "file",
            "file": {
                "url": "https://s3-sa-east-1.amazonaws.com/altu-assets/dev/profiles/1/avatar",
                "type": "PNG",
                "name": "avatar.png",
                "caption": "Esta imagem é usada como avatar",
                "size": "3127"
            }
        }
    }
]

O output de arquivo a seguir é utilizado para enviar um arquivo a todos canais com suporte ao envio de arquivos. O arquivo é acessível através do id de mídia no canal Whatsapp de origem Facebook e acessível através de uma URL pública nos demais canais.

[
    {
        "default": {
            "type": "file",
            "file": {
                "url": "https://prime.altubots.com/chats/dev/cesar/07db4c9e4559050116d38e660548749a/uploads/3660b5fe-4c62-8979-2619-761f234892bf/20200909165426883_gato.jpg",
                "whatsapp_media_id": "bc5e2bc0-845c-49bd-80a8-8675ac973c5f",
                "type": "JPEG",
                "name": "gato.jpg",
                "caption": "Veja este gatinho",
                "size": "145126"
            }
        }
    }
]

Compatibilidades:

Compatíveis

  • imagens: JPEG /JPG / PNG

  • vídeos: MP4

  • musica: MP3

  • documentos: DOCX / PDF /XLSX e TXT

Não compatível com GIF, PPTX (Power Point) e compactadores RAR/ZIP

Compatíveis

  • imagens: JPEG /JPG / PNG

  • vídeos: MP3

  • documentos: DOCX / PDF /XLSX

Não compatível com GIF, PPTX (Power Point) , compactadores RAR/ZIP, vídeo MP4 e TXT

Compatíveis

  • imagens: JPEG /JPG / PNG

  • vídeos: MP4

  • musica: MP3

  • documentos: DOCX / PDF /XLSX e PPXT

Não compatível com GIF e TXT

Stickers

Envie sticker por meio de um template para o usuário , segue template:

{
        "default": {
            "file": {
                "url": "<url_da_imagem>.webp",
                "name": "<nome_da_imagem>.webp",
                "type": "WEBP",
                "caption": "Descrição do sticker",
                "size": <tamanho em byte>
            },
            "type": "file"
        }
    }

Multiplos arquivos

Estrutura:

O output de arquivo é usado da seguinte maneira:

[
    {
        "default": {
            "file": {
                "url": "https://altuclients.s3.sa-east-1.amazonaws.com/Demo/imagens/jogo1.jpg",
                "name": "jogo1.jpg",
                "size": "20900",
                "type": "JPG",
                "caption": "primeiro jogo"
            },
            "type": "file"
        }
    }
]

Para usar dessa maneira, é necessário que o array criado tenha o mesmo formato que o output de arquivo para um arquivo só, ou seja, o array deve conter vários objetos do tipo file.

Exemplo:

"file_array": [
            {
                "url": "https://altuclients.s3.sa-east-1.amazonaws.com/Demo/imagens/jogo1.jpg",
                "name": "jogo1.jpg",
                "size": "20900",
                "type": "JPG",
                "caption": "primeiro jogo"
            },
            {
                "url": "https://altuclients.s3.sa-east-1.amazonaws.com/Demo/imagens/jogo2.jpg",
                "name": "jogo2.jpg",
                "size": "17600",
                "type": "JPG",
                "caption": "segundo jogo"
            },
            {
                "url": "https://altuclients.s3.sa-east-1.amazonaws.com/Demo/imagens/jogo3.jpg",
                "name": "jogo3.jpg",
                "size": "35600",
                "type": "JPG",
                "caption": "3 jogo"
            },
            {
                "url": "https://altuclients.s3.sa-east-1.amazonaws.com/Demo/imagens/jogo4.jpeg",
                "name": "jogo4.jpeg",
                "size": "15600",
                "type": "JPEG",
                "caption": "4 jogo"
            },
            {
                "url": "https://altuclients.s3.sa-east-1.amazonaws.com/Demo/imagens/jogo5.jpeg",
                "name": "jogo5.jpeg",
                "size": "11700",
                "type": "JPEG",
                "caption": "5 jogo"
            }
        ]

O array file_array foi criado onde cada objeto possui os seguintes campos:

  • url

  • name

  • size

  • type

  • caption.

Para usar no output, basta usar o nome da variável criada:

 {
        "default": {
            "file": "<?$file_array?>",
            "type": "file"
        }
 }

Dessa forma, todas as imagens serão mostradas para o usuario.

Também é possível passar o array diretamente no output (sem o uso de uma variável).

{
        "default": {
            "file": [
                {
                    "url": "https://altuclients.s3.sa-east-1.amazonaws.com/Demo/imagens/jogo1.jpg",
                    "name": "jogo1.jpg",
                    "size": "20900",
                    "type": "JPG",
                    "caption": "primeiro jogo"
                },
                {
                    "url": "https://altuclients.s3.sa-east-1.amazonaws.com/Demo/imagens/jogo2.jpg",
                    "name": "jogo2.jpg",
                    "size": "17600",
                    "type": "JPG",
                    "caption": "segundo jogo"
                },
                {
                    "url": "https://altuclients.s3.sa-east-1.amazonaws.com/Demo/imagens/jogo3.jpg",
                    "name": "jogo3.jpg",
                    "size": "35600",
                    "type": "JPG",
                    "caption": "3 jogo"
                },
                {
                    "url": "https://altuclients.s3.sa-east-1.amazonaws.com/Demo/imagens/jogo4.jpeg",
                    "name": "jogo4.jpeg",
                    "size": "15600",
                    "type": "JPEG",
                    "caption": "4 jogo"
                },
                {
                    "url": "https://altuclients.s3.sa-east-1.amazonaws.com/Demo/imagens/jogo5.jpeg",
                    "name": "jogo5.jpeg",
                    "size": "11700",
                    "type": "JPEG",
                    "caption": "5 jogo"
                }
            ],
            "type": "file"
        }
    }
PreviousLivePerson - Conteúdo EstruturadoNextInput

Last updated 2 years ago

Was this helpful?

O id da imagem ou documento enviado para o cliente da API do WhatsApp Business. Poderá utilizar qualquer id válido. Este parâmetro tem precedência ao parâmetro url em canal Whatsapp de origem Facebook. Consulte mais informações sobre na documentação do Facebook.

Mídia