Construa sobre o PinsCorner: API REST, GraphQL e webhooks

Um cartão de visita digital vale o quanto ele consegue comunicar com o resto das suas ferramentas. Quando alguém escaneia o seu cartão e deixa os dados de contacto, esse lead deveria chegar ao seu CRM em segundos — não esperar que se lembre de exportar um CSV. O PinsCorner é construído sobre o Payload CMS, o que significa que toda a camada de dados está exposta através de uma API REST e GraphQL nativa, complementada por um sistema de webhooks para entrega de eventos em tempo real.

Seja consultor independente, responsável por uma equipa de vendas ou desenvolvedor de produtos para clientes, a camada de API e webhooks transforma o PinsCorner num nó ativo da sua infraestrutura de negócio — muito além de uma simples ferramenta para partilhar cartões.

REST e GraphQL: duas formas de aceder aos seus dados

O PinsCorner oferece acesso REST e GraphQL, autenticado com chaves de API geradas nas definições da sua conta. REST é ideal para scripts, integrações de backend e serviços que já seguem o padrão clássico de pedido-resposta. GraphQL adapta-se melhor a aplicações front-end ou a cenários em que pretende recuperar exatamente os campos de que precisa, sem dados desnecessários ou múltiplas chamadas.

Através da API pode ler e escrever cartões, contactos, leads, membros de equipa e muito mais. Isto permite construir dashboards internos que mostram as análises dos seus cartões a par de outras métricas de negócio, sincronizar dados com um data warehouse para relatórios avançados, ou criar cartões de forma programática ao integrar novos membros de equipa em larga escala.

• Gere chaves de API por utilizador ou por integração, com controlo de permissões
• Consulte qualquer coleção — cartões, leads, contactos, equipas — via REST ou GraphQL
• Escreva no PinsCorner: crie ou atualize cartões e contactos a partir de sistemas externos
• Use GraphQL para pedir apenas os campos necessários e reduzir o tamanho das respostas
• Aceda à documentação do esquema gerada automaticamente a partir do seu painel de controlo

Webhooks assinados: reaja no instante em que tudo acontece

Para processamentos em lote, consultar uma API periodicamente pode ser suficiente. Mas para tudo o que é sensível ao tempo — um novo lead, uma visualização de cartão, um contacto guardado — precisa de push. O PinsCorner envia webhooks assinados com HMAC para o endpoint que configurar, de forma que o seu backend seja notificado no exato momento em que o evento ocorre.

A assinatura HMAC garante que cada payload carrega uma assinatura calculada a partir de um segredo partilhado. O seu servidor verifica essa assinatura antes de processar o evento, o que assegura que o pedido veio realmente do PinsCorner e não foi alterado em trânsito. É o mesmo mecanismo usado pelo Stripe e pelo GitHub: simples, robusto e de confiança sem expor o seu endpoint ao mundo.

• Lead capturado: disparado quando um visitante submete o formulário de captação em qualquer cartão
• Eventos de cartão: visualizações, contactos guardados e scans de QR
• Configure um ou vários endpoints por tipo de evento
• Verifique a assinatura HMAC no seu handler antes de processar o payload
• Mecanismo de reenvio automático em caso de falha na entrega

Quem beneficia mais

A camada de API e webhooks é genuinamente útil para uma grande variedade de equipas. As equipas de vendas podem encaminhar cada lead capturado diretamente para o seu CRM — HubSpot, Salesforce, Pipedrive — sem qualquer intervenção humana. As equipas de marketing podem desencadear sequências de email automatizadas no momento em que alguém guarda um cartão. Os programadores que constroem produtos de marca branca para clientes podem gerir centenas de cartões de forma programática, mantendo o seu próprio sistema de registo sincronizado com o PinsCorner.

As agências e os construtores de SaaS beneficiam especialmente do esquema nativo do Payload: como o PinsCorner é construído sobre o Payload CMS, a API não é uma camada adicionada depois. É a mesma camada que o painel de administração utiliza — completa, documentada e estável.

As melhores integrações são as que já não precisamos de pensar: os dados fluem automaticamente, os leads chegam onde devem, e a sua equipa dedica o tempo às conversas — não a copiar e colar contactos.

Como começar

Para ligar um sistema externo, gere uma chave de API nas definições da sua conta PinsCorner, consulte a documentação do esquema REST ou GraphQL gerada automaticamente e configure um endpoint de webhook para os eventos que lhe interessam. A maioria das integrações fica pronta em menos de uma hora. Ferramentas no-code como Make ou Zapier também podem consumir os webhooks, por isso não precisa de um programador para aproveitar o encaminhamento de leads em tempo real.

Se está pronto para integrar o PinsCorner no seu stack, a documentação da API está disponível dentro do seu painel de controlo. Comece com uma conta gratuita e atualize para um plano Pro ou Team quando precisar de limites de taxa mais elevados e de um histórico completo de webhooks.