Como podemos ajudar?

Zenvia Customer Cloud for Devs (APIs)
8 min
Criado por Ligia Sarmento em 27/02/2024 15:31
Atualizado por Leonora Alves em 14/08/2025 10:10

LOGO_Zenvia - Simbolo_Positivo.png

Comece sua jornada com as integrações Zenvia Customer Cloud for Devs (APIs)

Obtenha recursos, informações e tutoriais para começar a usar nossas APIs


A Zenvia oferece dois tipos principais de integração via API na Customer Cloud: APIs do tipo CDP (Customer Data Platform) e APIs Funcionais. 

Cada grupo atende a propósitos distintos e permite que sua empresa conecte sistemas externos ao Zenvia Customer Cloud para automatizar processos, enriquecer dados e potencializar resultados em atendimento e marketing.

APIs CDP

As APIs CDP transformam o Zenvia Customer Cloud em uma plataforma de dados do cliente (Customer Data Platform). 

Com elas, você pode integrar dados estratégicos do seu negócio, como informações de contatos, produtos, pedidos e notas fiscais. Esses dados alimentam a base unificada de clientes da plataforma e permitem a personalização de campanhas, automações e atendimentos.

Quais dados posso integrar com as APIs CDP?

Contatos
Dados relacionados às pessoas que interagem com a sua empresa. Campos comuns: Nome e sobrenome do contato, data de nascimento, E-mail, Telefone, Endereço, entre outros. 

Produtos
Informações sobre os itens que sua empresa comercializa. Campos comuns: Nome do produto, Código de barras, Marca, Descrição do produto, Preço unitário, entre outros. 

Pedidos
Detalhes sobre as compras realizadas pelos seus clientes. Campos comuns: Código interno da nota ou do contato, Número de ID do pedido, Data e hora do pedido, Valor total do pedido, Status do pedido, Dados pessoais do cliente, entre outros.

Notas fiscais
Dados fiscais importantes para gestão e compliance. Campos comuns: Data e hora da emissão da nota, Número da nota fiscal, Número do pedido, Nome legal da empresa emissora, Nome e descrição do produto, entre outros. 

Depois que seus dados são integrados ao Customer Cloud, eles passam a ser usados de várias formas para tornar suas estratégias mais inteligentes e personalizadas.

Separamos um cenário com alguns exemplos de como esses dados podem ser aplicados na prática. Para isso, vamos considerar um e-commerce: 

Uma loja de perfumes quer automatizar a campanha de Dia dos Namorados, promovendo produtos para clientes que compraram recentemente, usando o Zenvia Customer Cloud integrado às APIs de Contatos, Produtos, Pedidos e Nota Fiscal.

API de Contatos

  1. A loja sincroniza automaticamente os dados cadastrais dos clientes (nome, e-mail, telefone, localização) do sistema de gestão para o Zenvia Customer Cloud.

  2. Cria uma base segmentada na Base de Contatos, filtrando clientes que realizaram compras no último mês.

  3. Realiza o envio em massa no módulo Atrair para contatos que atendem à regra.

API de Produtos

  1. A loja importa as informações do catálogo de perfumes: nome, fragrância, preço, etc.

  2. A loja cria uma base de conhecimento com todas as informações e utiliza um Chatbot de IAG configurado para responder todas as dúvidas.

  3. Chatbot transfere a conversa para um atendimento humano no módulo Atendimento comercial e o agente fecha a compra direto com o cliente. 

API de Pedidos

  1. A loja sincroniza o histórico de compras, incluindo datas, valores e produtos adquiridos.

  2. No módulo Atrair, usa a Regra de Segmentação já criada para identificar os clientes que compraram recentemente e que podem se interessar por uma oferta especial de Dia dos Namorados.

  3. Configura o Envio em Massa via WhatsApp, personalizando a mensagem com detalhes da promoção e convidando o cliente a conhecer as novidades.

API de Nota Fiscal

  1. A loja integra as informações fiscais: número da nota, data de emissão e itens vendidos.

  2. No módulo Nutrir, configura um Agente Especialista que dispara automaticamente uma mensagem de agradecimento e confirmação da compra sempre que uma nota fiscal for gerada, reforçando a confiança e o relacionamento com o cliente.

Acesse as documentações técnicas para implementar as APIs CDP do Zenvia Customer Cloud:

API de Contatos

API de Produtos

API de Pedidos

API de Nota Fiscal

Cada arquivo contém os detalhes necessários para integração, incluindo endpoints, parâmetros, exemplos de requisição e resposta.

APIs Funcionais

As APIs funcionais permitem que sistemas externos acionem funcionalidades específicas dentro do Zenvia Customer Cloud. 

Elas são ideais para executar ações diretas e pontuais - como enviar mensagens, criar leads, consultar tickets ou disparar automações - sem a necessidade de sincronizar grandes volumes de dados.

Quais são e o que posso fazer com as APIs funcionais disponíveis?

Multicanal
Envio de mensagens por diversos canais de comunicação, incluindo SMS, WhatsApp, Instagram, Facebook, RCS, Telegram, Google Business Messages e E-mail. Ideal para campanhas integradas, garantindo alcance consistente em múltiplas plataformas a partir de uma única integração.

Contatos
Criação, atualização e consulta detalhada da base de contatos, incluindo a gestão de campos personalizados e organização em listas segmentadas. Facilita o controle e a personalização das informações para melhorar o relacionamento com clientes.

Automações de marketing
Configuração de gatilhos e ações automatizadas que podem ser acionadas por eventos internos da plataforma ou externos via API. Isso possibilita integrar fluxos de trabalho personalizados, respondendo automaticamente a comportamentos do cliente e otimizando campanhas e processos.

Atendimento comercial
Envio de leads e informações de contato ao Zenvia Customer Cloud de forma assíncrona. Receba notificações via webhook sobre o status dos leads, facilitando a automação e acompanhamento em tempo real pelo time comercial.

Consulta de tickets
Consulta de tickets com filtros, status e informações detalhadas de atendimento. Facilita a análise e integração dos dados de atendimento para geração de relatórios e suporte a decisões operacionais.

Aprofunde-se em cada API funcional com nossos artigos dedicados. Entenda o propósito e veja exemplos de uso:

API de Contatos

API de Automações de marketing

API de Atendimento comercial

API de Consulta de tickets

Ambiente de testes e autenticação

Utilize o ambiente de testes do Zenvia Customer Cloud para validar suas requisições com segurança antes de colocar a integração em produção.

  

O tráfego no Sandbox não é cobrado, mas para utilizar essa funcionalidade é necessário possuir um plano ativo.


Todas as APIs utilizam autenticação via token (Bearer Token).