← Voltar

24/07/2025 22:24:51

Como integrar com uma webhook genérica

Conta de anúncio

Se você possui uma plataforma própria ou a plataforma de vendas que você utiliza não possui integração com a Dimpple, você pode integrar utilizando nossa webhook genérica.

Para isso, basta formatar o envio da webhook da sua plataforma no formato esperado ou configurar uma integração com a n8n.

Veja o formato de JSON esperado:

code: (string), // Código da venda
registration_date: (datetime), // Data de registro
last_status_date: (datetime), // Data do último status
status: waiting|testing|approved|reversed|refunded|chargeback, // Status da venda
payment_method: creditcard|pix|billet|other, // Método de pagamento
total: (integer), // Valor total da venda em centavos.
products: (array), // Lista de produtos
products.code: (string), // Código do produto
products.name: (string), // Nome do produto
products.image: (string)(opcional), // Imagem do produto
commissions: (array), // Lista de comissões (informar ao menos a de produtor)
commissions.type: producer|coproducer|affiliate|manager, // Tipo de comissão
commissions:value: (integer), // Valor da comissão em centavos
customer: (object), // Dados do cliente
customer.name: (string), // Nome do cliente
customer.email: (string), // E-mail do cliente
customer.phone: (string), // Telefone do cliente
customer.address: (object), // Dados de endereço (opcional)
customer.address.zipcode: (string), // CEP
customer.address.city: (string), // Cidade
customer.address.state: (string), // Estado (sigla)
customer.address.country: (string), // País (sigla)
tracking: (object), // Dados de traqueamento (informar ao menos o utm_content)
tracking.utm_source: (string),
tracking.utm_campaign: (string),
tracking.utm_medium: (string),
tracking.utm_content: (string),
tracking.utm_term: (string),
tracking.src: (string)

Nosso sistema receberá os dados da venda e tratará como das demais plataformas já integradas. Se o recebimento for "OK" nosso sistema retornará o código HTTP 200.

Veja um exemplo de dados enviados:

{
    "code": "12345678",
    "registration_date": "2025-08-10 16:34:21",
    "last_status_date": "2025-08-10 16:35:11",
    "status": "approved",
    "payment_method": "pix",
    "total": 1990,
    "products": [
        {
            "code": "12345",
            "name": "Produto de teste",
            "image": ""
        }
    ],
    "commissions": [
        {
            "type": "producer",
            "value": 1760
        }
    ],
    "customer": {
        "name": "Fulano de Tal",
        "email": "fulano@gmail.com",
        "phone": "11999123456",
        "address": {
            "zipcode": "11200001",
            "city": "São Paulo",
            "state": "SP",
            "country": "BR"
        }
    },
    "tracking": {
        "utm_source": "Facebook",
        "utm_campaign": "Primeira campanha",
        "utm_content": "1234567890123456|309e575c-da58-4767-a03b-45a7b48775ae|fb.1.1755197906.6715277524|fb.1.1755197906.IwZXh0bgNhZW0CMTEAAR6BD1-fQ0ucUqRXC5Smxbi7qCxt6XCEgFm_JoPeY9JWXmXrBCLoa3K6pCgcwQ_aem_YEnrS4L90n3mZQqEeTDL1w"
    }
}

Compartilhe esse conteúdo!