Envio de Documentos com WhatsApp Flow

Como configurar documentos para assinatura de signatários usando o WhatsApp Flow.

O recurso de WhatsApp Flow permite que documentos sejam assinados diretamente dentro do WhatsApp, sem a necessidade de abrir links externos. Todo o processo de assinatura ocorre na própria conversa, oferecendo mais praticidade e uma experiência fluida para os signatários.

Como usar

Para utilizar o recurso de assinatura via WhatsApp Flow, basta anexar um arquivo no formato Markdown (.md) e adicionar um novo parâmetro na criação do documento. O conteúdo do arquivo será exibido diretamente na conversa do WhatsApp, permitindo que o signatário visualize as informações e conclua a assinatura sem precisar abrir links externos.

mutation {                             
  createDocument(
    ...
    type: WHATSAPP_FLOW, # DocumentTypeEnum: DEFAULT = DEFAULT | WHATSAPP_FLOW
    ...   
  ) {
    id
    name
    refusable
    sortable
    created_at
    signatures {
      public_id
      name
      email
      created_at
      action { name }
      link { short_link }
      user { id name email }
    }
  }
}

Se um arquivo Markdown não for anexado e o parâmetro type for 'WHATSAPP_FLOW', será retornado um erro. Da mesma forma, se o arquivo Markdown for anexado, mas o parâmetro type não for informado, também será retornado um erro.

Para os demais signatários que não foram anexados para assinatura via WhatsApp, o documento será renderizado normalmente e o fluxo segue o padrão.

O envio via WhatsApp Flow não suporta verificações por SMS, validação de fotos de documentos nem a definição de CPF para signatários que assinam pelo WhatsApp.

Tags Markdown suportadas

A API do WhatsApp oferece suporte apenas às seguintes tags Markdown:

# Text Heading
## Text Subheading
Normal Paragraph

**bold**
*italic*
~~strikethrough~~

Lista não ordenada NÃO aceita subníveis
+ Item 1
+ Item 2

Lista Ordenada também NÃO aceita subníveis
1. Item 1
2. Item 2

![Image Alt](data:image/png;base64, base64-data)

TABELA

| Header 1 | Header 2 | Header 3  |
| -------- | -------- | --------  |
| Row 1    | Data 1   | More Data |
| Row 2    | Data 2   | More Data |
| Row 3    | Data 3   | More Data | 

456B

supported-whatsapp-flow-tags.md