Webhook é um recurso usado para que um sistema (no caso o PowerCRM) se comunique com outros sistemas, fornecendo dados em tempo real sempre que um evento acontecer. Desta forma os dois sistemas realizam troca de informações sem que nenhuma ação externa precise ser realizada.
Hoje nossa webhook está configurada para enviar informações sempre que os eventos abaixo acontecerem:
Pagamentos
- Boleto gerado
- Boleto pago
- Boleto vencido
- Confirmação de recebimento em dinheiro
- Pagamento no cartão
Vistorias
- Vistoria liberada
- Vistoria realizada
- Vistoria aprovada
- Vistoria reprovada
- Vistoria retornada
Negociações
- Cartão movido para a última coluna
- Cartão arquivado
- Cartão enviado para o SGA
Como utilizar
Você precisa criar um endpoint em seu sistema
Você pode usar token ou não
O PowerCRM irá enviar a requisição abaixo:
{
"negotiationCode": "string",
"quotationCode": "string",
"status": "string",
"hash": "string"
}
No campo negociationCode nós enviamos o código da negociação
No campo quotationCode nós enviamos o código da cotação
No campo status nós enviamos os eventos listados acima
No campo hash nós enviamos um hash (opcional) que pode ser cadastrado no momento da criação da cotação
No PowerCRM, vá até o menu Minha Empresa > Integrações > Power Webhook
Clique no botão para adicionar uma webhook
Você pode cadastrar uma webhook para cada evento mencionado acima no inicio deste post.
Para cada webhook você precisa passar as seguintes informações:
Título do webhook
URL
Token (opcional)
Tipo
Status
OBS. Lembrando que na url é necessário enviar http:// e a sua url, o nosso webhook também atende urls com https://
