Marketing
Manychat no seu produto e nos seus agentes de IA, por uma API
O toolkit do Manychat cobre contatos (consultar, buscar, criar, atualizar), tags, campos personalizados e automações (flows): listar, aplicar tags, definir valores de campos e iniciar um flow para um contato. O Connect guarda a chave de API de cada cliente e registra cada execução, para o seu produto ou agente de IA acionar automações de chat sem uma integração própria.
15 dias para testar. Sem cartão de crédito.
POST https://connect.reportei.com/api/tools/manychat_create_subscriber/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"first_name": "<first_name>"
}
}Como funciona
Do cliente conectado à primeira chamada no Manychat.
- 1
O cliente conecta a conta
Seu sistema abre uma sessão do Connect para o toolkit e o cliente conecta a conta do Manychat. Você recebe o id da conexão.
- 2
Seu produto chama a tool
Um POST em /api/tools/{tool}/execute com o id da conexão e os argumentos. Em caso de sucesso, o Connect preserva o status e o corpo da resposta do app.
- 3
O Connect cuida do resto
Guarda a credencial criptografada, renova tokens quando a conexão usa OAuth com suporte a renovação e registra as execuções numa trilha de auditoria consultável pela API.
Para que usar
O que o seu produto faz com o Manychat.
Sincronizar seus usuários no Manychat
Crie ou atualize um contato a partir do seu produto, defina campos personalizados com Set custom fields e aplique uma tag para iniciar as automações da conta.
Disparar um flow após um evento
Quando uma compra ou um ticket acontece no seu SaaS, encontre o contato por e-mail ou telefone e inicie um flow com Send flow, dentro das regras de mensagens da Meta.
Agente de suporte que etiqueta contatos
Um agente de IA busca um contato pelo nome, lê seus campos e tags e aplica ou remove uma tag para encaminhar a conversa.
Tools
14 tools do Manychat
- Consultar contatoGETRetorna um contato com nome, e-mail, telefone, WhatsApp, usuário do Instagram, opt-ins, última interação, campos personalizados e tags.
- Consultar contato por e-mail ou telefoneGETRetorna o contato com este e-mail ou telefone, com os mesmos campos de Get subscriber. Envie email ou phone, não os dois.
- Buscar contatos por nomeGETRetorna até 100 contatos cujo nome completo corresponde, com os mesmos campos de Get subscriber.
- Criar contatoPOSTCria um contato com um e-mail, um telefone de SMS ou um telefone de WhatsApp, ao menos um deles, e o retorna com seu id. Cada canal enviado exige seu opt-in: has_opt_in_email para e-mail, e has_opt_in_sms com consent_phrase para telefone.
- Atualizar contatoPOSTAtualiza nome, e-mail, telefone, gênero ou opt-ins de um contato. Mudar e-mail ou telefone exige o opt-in de novo: has_opt_in_email para e-mail, e has_opt_in_sms com consent_phrase para telefone.
- Listar tagsGETLista as tags da conta com id e nome.
- Criar tagPOSTCria uma tag na conta e a retorna com seu id.
- Aplicar tagPOSTAplica uma tag a um contato. As automações da conta que começam quando essa tag é aplicada rodam para o contato.
- Remover tagPOSTRemove uma tag de um contato. A tag continua na conta e nos outros contatos.
- Listar campos personalizadosGETLista os campos personalizados de usuário da conta com id, nome, tipo e descrição.
Chave de API
O cliente cola a chave do app numa tela do Connect, ou o seu sistema envia a chave por POST /api/customer-toolkits, sem tela.
Perguntas sobre o toolkit do Manychat
Preciso implementar a API do Manychat?
Não. O Connect já traz 14 tools do Manychat descritas e prontas. Seu cliente conecta a conta e o seu sistema chama cada tool pelo mesmo endpoint, com o mesmo formato de requisição.
Como o cliente conecta a conta do Manychat?
Pelo modo que o toolkit aceita: Chave de API. O Connect guarda a credencial criptografada e nunca a devolve ao seu sistema.
Funciona com agentes de IA?
Sim. O input de cada tool é descrito em JSON Schema, que o seu agente usa direto como definição de tool. O agente escolhe a tool e os argumentos, e o seu sistema faz a chamada ao Connect.
Meu cliente precisa ter conta no Reportei?
Não. O cliente conecta a conta numa tela do Connect, ou o seu sistema envia a credencial pela API, e ele continua usando só o seu produto.
Veja o Connect aplicado ao seu produto.
Teste por 15 dias sem cartão, ou mostre seu cenário ao nosso time.
