PHPackages                             bellinatiperez/mautic-plugin-custom-webhook - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. bellinatiperez/mautic-plugin-custom-webhook

ActiveMautic-plugin

bellinatiperez/mautic-plugin-custom-webhook
===========================================

Custom Webhook

1.0.0(7mo ago)03911PHP

Since Sep 30Pushed 7mo agoCompare

[ Source](https://github.com/bellinatiperez/mautic-plugin-custom-webhook)[ Packagist](https://packagist.org/packages/bellinatiperez/mautic-plugin-custom-webhook)[ RSS](/packages/bellinatiperez-mautic-plugin-custom-webhook/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependenciesVersions (2)Used By (1)

Mautic Custom Webhook Plugin
============================

[](#mautic-custom-webhook-plugin)

Um plugin avançado para Mautic que permite enviar webhooks personalizados com estrutura JSON flexível e interpolação completa de dados do contato.

Características Principais
--------------------------

[](#características-principais)

### 1. Campo de Dados Flexível

[](#1-campo-de-dados-flexível)

- Estrutura JSON completamente personalizável
- Suporte a objetos aninhados e arrays
- Interpolação automática de tokens do contato
- Validação de JSON em tempo real

### 2. Interpolação de Dados

[](#2-interpolação-de-dados)

O plugin suporta todos os tokens padrão do Mautic:

- `{contactfield=firstname}` - Nome do contato
- `{contactfield=email}` - Email do contato
- `{contactfield=company}` - Empresa do contato
- `{date_now}` - Data/hora atual
- `{timestamp}` - Timestamp Unix atual
- E todos os outros campos personalizados do contato

### 3. Exemplo de Payload JSON

[](#3-exemplo-de-payload-json)

```
{
  "name": "{contactfield=firstname} {contactfield=lastname}",
  "email": "{contactfield=email}",
  "variables": [
    {
      "key": "document",
      "value": "{contactfield=document}"
    },
    {
      "key": "phone",
      "value": "{contactfield=phone}"
    }
  ],
  "metadata": {
    "campaign_id": "{campaign_id}",
    "sent_at": "{date_now}",
    "timestamp": "{timestamp}"
  },
  "attachments": [
    {
      "fileUrl": "https://example.com/files/{contactfield=document}.pdf",
      "fileName": "document_{contactfield=firstname}.pdf",
      "fileType": "PDF"
    }
  ]
}
```

Configuração
------------

[](#configuração)

### 1. URL do Webhook

[](#1-url-do-webhook)

- Suporte a tokens na URL: `https://api.example.com/webhook/{contactfield=id}`
- Validação de URL
- Suporte a HTTPS e HTTP

### 2. Métodos HTTP Suportados

[](#2-métodos-http-suportados)

- GET
- POST
- PUT
- PATCH
- DELETE

### 3. Cabeçalhos Personalizados

[](#3-cabeçalhos-personalizados)

Formato: um cabeçalho por linha

```
Authorization: Bearer {contactfield=api_token}
X-Custom-Header: {contactfield=custom_value}
Content-Type: application/json

```

### 4. Timeout

[](#4-timeout)

- Configurável de 1 a 300 segundos
- Padrão: 30 segundos

Recursos Técnicos
-----------------

[](#recursos-técnicos)

### Arquitetura Desacoplada

[](#arquitetura-desacoplada)

- Implementação baseada em eventos
- Fácil extensibilidade
- Compatibilidade com futuras versões do Mautic

### Validação Robusta

[](#validação-robusta)

- Validação de JSON em tempo real
- Verificação de URLs
- Tratamento de erros HTTP
- Logs detalhados

### Performance

[](#performance)

- Cache de valores do contato
- Processamento otimizado de tokens
- Requisições HTTP assíncronas quando possível

Instalação
----------

[](#instalação)

1. Copie o plugin para `plugins/MauticCustomWebhookBundle/`
2. Limpe o cache do Mautic: `php bin/console cache:clear`
3. Instale/atualize o plugin no painel administrativo

Uso em Campanhas
----------------

[](#uso-em-campanhas)

1. Crie uma nova campanha ou edite uma existente
2. Adicione uma nova ação
3. Selecione "Enviar Webhook Personalizado"
4. Configure:
    - URL do webhook
    - Método HTTP
    - Payload JSON personalizado
    - Cabeçalhos (opcional)
    - Timeout

Eventos Personalizados
----------------------

[](#eventos-personalizados)

O plugin dispara eventos que podem ser interceptados:

- `mautic.custom_webhook.on_request` - Antes de enviar a requisição
- `mautic.custom_webhook.on_campaign_trigger_action` - Quando a ação é executada

Logs e Debugging
----------------

[](#logs-e-debugging)

Todos os webhooks são logados com:

- ID do contato
- URL de destino
- Método HTTP
- Status da resposta
- Erros (se houver)

Verifique os logs em `var/logs/mautic_prod.log` ou `var/logs/mautic_dev.log`

Compatibilidade
---------------

[](#compatibilidade)

- Mautic 4.x+
- PHP 8.0+
- Symfony 5.4+

Suporte
-------

[](#suporte)

Para suporte e relatórios de bugs, consulte a documentação do Mautic ou entre em contato com o desenvolvedor.

###  Health Score

32

—

LowBetter than 71% of packages

Maintenance67

Regular maintenance activity

Popularity12

Limited adoption so far

Community5

Small or concentrated contributor base

Maturity35

Early-stage or recently created project

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

221d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/c4970fb958f38eb5b7bef9a60c2cba0758aa2c5c3e597f1a71d52b411f89d5cb?d=identicon)[bellinatiperez](/maintainers/bellinatiperez)

---

Tags

pluginMauticintegration

### Embed Badge

![Health badge](/badges/bellinatiperez-mautic-plugin-custom-webhook/health.svg)

```
[![Health](https://phpackages.com/badges/bellinatiperez-mautic-plugin-custom-webhook/health.svg)](https://phpackages.com/packages/bellinatiperez-mautic-plugin-custom-webhook)
```

###  Alternatives

[mautic/grapes-js-builder-bundle

GrapesJS Builder with MJML support for Mautic

5684.1k4](/packages/mautic-grapes-js-builder-bundle)[etailors/mautic-amazon-ses

Amazon SES Mailer Plugin for Mautic

522.0k](/packages/etailors-mautic-amazon-ses)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)