BlocoPro
Skip to main content
Qual é a sua dúvida?
Sumário
< Todos os artigos
Imprimir
Atualizado em

O que são webhooks de automação

Os webhooks de automação permitem o envio automático de mensagens para um número de destino a partir de um sistema externo, utilizando parâmetros em formato JSON.

⚙️ Essa funcionalidade pode ser usada tanto na API oficial quanto na não oficial do WhatsApp.

  • API oficial: permite envio apenas de mensagens template ou quando existe uma conversa ativa.
  • API não oficial: permite envio livre de mensagens automáticas.

Entrada de dados

A entrada de dados define a URL que receberá as requisições HTTPS (payloads).

Passos:

  1. Acesse Webhooks › Automação › Entradas de dados.
  2. Clique em Novo.
  3. Selecione a opção Genérico.
  4. Clique em Incluir.

A URL será criada e ficará disponível para uso em todas as automações.

Configurações de envio

Nesta etapa, são definidos os parâmetros específicos de envio das mensagens.

Criar configuração de envio:

  1. Acesse Webhooks › Automação › Configurações de envio.
  2. Clique em Novo.
  3. Preencha os campos conforme abaixo:
CampoDescrição
OrigemGenérico
CanalSelecione o canal de atendimento
DepartamentoEscolha o departamento responsável
ID de integraçãoValor numérico (8 dígitos, sem letras ou caracteres especiais)
Ação de atendimentoEscolha o comportamento após o envio da mensagem:
– Finalizar atendimento após envio
– Mover para fila após contato (não compatível com distribuição automática)
– Mover para fila após envio
  1. Clique em Incluir para salvar.

Configuração da mensagem

  1. Na seção Mensagens, clique em Novo.
  2. Defina o conteúdo da mensagem.
    • É possível usar variáveis (por exemplo, @nome) que serão substituídas automaticamente pelos valores recebidos no payload JSON.
    • Suporta emojis e anexos (imagens, áudios e documentos).
  3. Clique em Incluir para salvar e depois em Voltar para retornar à tela principal.

Histórico

O Histórico exibe todos os registros de envios realizados via Webhook.

Para acessar:

  1. Vá em Webhooks › Automação › Histórico.
  2. Os registros são exibidos em ordem decrescente.
  3. Clique em … para visualizar detalhes, gerar um PDF ou imprimir o registro.

HTTPS Request

Com as configurações finalizadas, o BlocoPro estará apto a receber requisições externas para envio de mensagens automáticas.

Exemplo de configuração no Postman

  1. URL: utilize a mesma criada em Entradas de dados.
  2. Método: POST
  3. Body: selecione raw / JSON
  4. Payload (exemplo):
{
  "telefone": "5551999966666",
  "id_integracao": "00000001",
  "nome": "Enio Eltz",
  "email": "enio@uniteltelecom.com",
  "cpf": "106000",
  "cidade": "Taquara",
  "estado": "RS",
  "produto": "Central inoperante após temporal.",
  "total": "total",
  "observacoes": "observações"
}

Todos os parâmetros devem ser enviados como strings.

Dicas e boas práticas

  • Utilize IDs de integração únicos para evitar duplicidade de mensagens.
  • Garanta que o payload JSON contenha todos os parâmetros esperados.
  • Teste as requisições no Postman antes da integração com sistemas externos.
  • Mantenha um controle periódico do Histórico para auditoria de envios.

Atualizado em