Escrever no WhatsApp por meio das nossas APIs

Esta funcionalidade permite que o seu sistema de gestão ou qualquer outro software externo se comunique diretamente com seus clientes no WhatsApp, usando a Quoting24 como ponte.

Em palavras simples, graças a esta integração é possível enviar mensagens e documentos de forma automática, sem precisar abrir a aplicação da Quoting24 e sem precisar copiar e colar manualmente os dados.

O que é possível fazer?

Usando esta conexão, o seu sistema de gestão pode executar três ações principais de uma só vez:

Enviar uma mensagem de texto

Você pode escrever ao cliente qualquer informação: um aviso de mercadoria pronta, uma confirmação de pedido ou uma simples saudação.

Enviar arquivos e documentos (PDF, imagens, etc.)

Junto com o texto, você pode anexar arquivos. Muito útil, por exemplo, para enviar o PDF de um orçamento ou de uma fatura diretamente no chat WhatsApp do cliente.

Fechar automaticamente a solicitação (Ticket)

Muitas vezes, quando se envia um orçamento ou uma confirmação, a operação pode ser considerada concluída.

É possível dizer ao sistema para "arquivar" (fechar) imediatamente a conversa depois do envio da mensagem, para manter limpa a lista de solicitações abertas na Quoting24 sem precisar fazer isso manualmente.

Detalhes técnicos para a integração

Está disponível um endpoint para enviar mensagens a um contato individual por meio da WhatsApp Business API.

A autenticação acontece por meio do header X-API-Key usando a chave API do seu tenant, disponível nas configurações da conta.

Enviar mensagem a um contato

Endpoint: https://api.quoting24.com/webhook/sendmessage

Mensagem de texto:

curl --request POST \
  --url https://api.quoting24.com/webhook/sendmessage \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <la-tua-api-key>' \
  --data '{
    "tenant_id": "<il-tuo-tenant-id>",
    "phone_number": "+39123456789",
    "channel": "whatsapp-api",
    "message_content": {
      "text": "Ciao! Il tuo preventivo è pronto."
    },
    "auto_close_ticket": true
  }'

Mensagem com imagem ou documento (URL público):

curl --request POST \
  --url https://api.quoting24.com/webhook/sendmessage \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <la-tua-api-key>' \
  --data '{
    "tenant_id": "<il-tuo-tenant-id>",
    "phone_number": "+39123456789",
    "channel": "whatsapp-api",
    "message_content": {
      "type": "file",
      "text": "In allegato il tuo preventivo.",
      "file": {
        "url": "https://esempio.com/preventivo.pdf",
        "name": "preventivo.pdf",
        "mime_type": "application/pdf"
      }
    },
    "auto_close_ticket": true
  }'

Parâmetros message_content:

Campo	Tipo	Obrigatório	Descrição
`type`	`text` / `image` / `video` / `audio` / `file`	Não, padrão `text`	Tipo de mensagem
`text`	string	Não	Texto da mensagem ou legenda do arquivo
`file.url`	string URL	Sim, se `type` for diferente de `text`	URL público do arquivo a enviar
`file.name`	string	Sim, se `type` for diferente de `text`	Nome do arquivo com extensão, por exemplo `preventivo.pdf`
`file.mime_type`	string	Sim, se `type` for diferente de `text`	Tipo MIME, por exemplo `application/pdf` ou `image/jpeg`

Parâmetros principais:

Campo	Descrição
`tenant_id`	ID do seu tenant, disponível nas configurações
`phone_number`	Número de telefone do cliente com prefixo internacional, por exemplo `+39123456789`
`channel`	`whatsapp-api` para WhatsApp Business API
`auto_close_ticket`	`true` para fechar automaticamente o ticket depois do envio

Nota: o arquivo a anexar deve ser acessível por meio de um URL público. Se o arquivo vier de um sistema de gestão ou de um sistema interno, certifique-se de que ele seja acessível pela internet antes de passar o link para a API.

Nota operacional: o envio de mensagens segue as regras da Meta. Para iniciar conversas fora da janela de atendimento de 24 horas, podem ser necessários templates pré-aprovados.