Ações e Filtros

O PrimoCRM expõe ações do WordPress (eventos aos quais você pode reagir) e filtros (valores e registros que você pode modificar). Todos os ganchos usam o prefixo primocrm_.

Ganchos de ação (eventos)

Reaja a estes com add_action.

Ciclo de vida do contato

Gancho	Argumentos	Disparado quando
`primocrm_contact_created`	`$contact_id`	Um contato é criado
`primocrm_contact_updated`	`$contact_id, $changed_keys`	Um contato é atualizado (`$changed_keys` são os nomes dos campos alterados)
`primocrm_contact_status_changed`	`$contact_id, $new_status, $old_status`	O status de um contato muda
`primocrm_contact_unsubscribed`	`$contact_id`	Um contato se descadastra
`primocrm_contact_tag_added`	`$contact_id, $tag_id`	Uma etiqueta é aplicada
`primocrm_contact_tag_removed`	`$contact_id, $tag_id`	Uma etiqueta é removida
`primocrm_contact_list_added`	`$contact_id, $list_id`	Adicionado a uma lista
`primocrm_contact_list_removed`	`$contact_id, $list_id`	Removido de uma lista

Engajamento e formulários

Gancho	Argumentos	Disparado quando
`primocrm_form_submitted`	`$form_id, $entry_id, $contact_id, $data`	Um formulário do PrimoCRM é processado
`primocrm_email_opened`	`$contact_id, $campaign_id`	A abertura de um e-mail é rastreada
`primocrm_email_link_clicked`	`$contact_id, $campaign_id, $url`	Um link rastreado é clicado

Sistema

Gancho	Argumentos	Disparado quando
`primocrm_loaded`	nenhum	Dentro do registro de rotas da REST. Um handshake de catálogo, não um gancho de inicialização confiável
`primocrm_pro_downgraded`		Uma licença Pro é perdida ou expira
`primocrm_pro_resumed`		Uma licença Pro é restaurada
`primocrm_ab_evaluate_winners`		A execução do cron que avalia os vencedores de A/B

Exemplo:

add_action( 'primocrm_contact_created', function ( $contact_id ) {
    error_log( "New PrimoCRM contact: {$contact_id}" );
} );

add_action( 'primocrm_email_link_clicked', function ( $contact_id, $campaign_id, $url ) {
    // Score the contact, notify a channel, etc.
}, 10, 3 );

Ganchos de filtro (registros)

Estes coletam itens extensíveis. Receitas completas estão em Estendendo o PrimoCRM.

Filtro	Valor	Finalidade
`primocrm_automation_triggers`	array	Registrar ou modificar gatilhos de automação
`primocrm_automation_actions`	array	Registrar ou modificar ações de automação
`primocrm_condition_options`	array (`fields`, `operators`)	Adicionar campos e operadores ao construtor de condições
`primocrm_form_field_types`	array (type para class)	Registrar tipos de campos de formulário personalizados
`primocrm_migration_sources`	array (key para source)	Registrar provedores de fontes de migração
`primocrm_smtp_send`	`$result, $provider, $atts, $settings`	Fornecer um remetente de e-mail (como os provedores de ESP se conectam)
`primocrm_ab_manager`	object	Fornecer a implementação do gerenciador de testes A/B

Ganchos de filtro (controle de acesso)

Filtro	Valor	Finalidade
`primocrm_free_triggers`	array de keys	Quais gatilhos são gratuitos (bloqueio padrão para o resto)
`primocrm_free_actions`	array de keys	Quais ações são gratuitas
`primocrm_free_limits`	array	Limites de contagem do plano gratuito por recurso
`primocrm_upgrade_url`	string	A URL para a qual os avisos de atualização direcionam

Ganchos de filtro (comportamento e ajustes)

Filtro	Valor	Finalidade
`primocrm_send_batch_size`	int	E-mails por lote do worker de campanhas
`primocrm_send_rate_per_hour`	int	Limitação de envio de campanhas
`primocrm_automation_batch_limit`	int	Linhas por lote do worker de automação
`primocrm_email_body_retention_days`	int	Quanto tempo os corpos de e-mail renderizados são mantidos
`primocrm_async_automation_delivery`	bool	Alternar entrega assíncrona de e-mails de automação
`primocrm_auto_create_contact_status`	`$status, $source`	Status para contatos criados automaticamente por gatilhos ou sincronização de usuários
`primocrm_trust_proxy_headers`	bool	Se deve confiar em cabeçalhos de proxy para o IP do remetente em formulários

Pontos de personalização de marca (White-label)

Filtro	Valor	Finalidade
`primocrm_brand_name`	string	O nome da marca exibido no painel administrativo
`primocrm_brand_menu_icon`	string	O ícone do menu administrativo
`primocrm_brand`	array	O descritor da marca localizado para o aplicativo

Ganchos JavaScript (wp.hooks)

O aplicativo administrativo expõe dois filtros JavaScript via wp.hooks para que complementos possam injetar interface de usuário. Eles retornam descritores com retornos de chamada de montagem, e não elementos React, porque o aplicativo e os complementos podem executar diferentes versões do React.

Filtro	Finalidade
`primocrm.settings.tabs`	Adicionar uma aba à tela de Configurações
`primocrm.campaigns.rowActions`	Adicionar uma ação a uma linha de campanha