---
title: "Integração do chatbot Chatfuel com Xtremepush"
slug: "chatfuel-chatbot-integration"
updated: 2026-06-12T10:30:54Z
published: 2026-06-12T10:30:54Z
canonical: "docs.xtremepush.com/chatfuel-chatbot-integration"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xtremepush.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Integração do chatbot Chatfuel com Xtremepush

Recomendamos a leitura do [nosso guia rápido de Chatbots e mensagens sociais](/documentation/docs/pt-br/quick-start-social) para se familiarizar com a integração do Facebook Messenger com o Xtremepush. Para integrar seu chatbot chatfuel com o Xtremepush, você precisará primeiro garantir que o plugin do FB Messenger que você usa para os usuários optem está enviando um ID Xtremepush de volta para o seu chatbot:

- [Enviar para o plugin Messenger](/documentation/docs/pt-br/quick-start-social#add-a-social-messaging-plug-in)
- [Plugin de Chat de Clientes](/documentation/docs/pt-br/facebook-customer-chat-plugin)

Em seguida, você precisará associar um ID do Facebook Messenger aos seus usuários no Xtremepush. Para fazer isso no chatfuel, você precisa inserir dois blocos que o usuário não verá no início do chatbot:

1. Um bloco de atributo de usuário de configuração
2. Um bloco API JSON

Você usará a API xtremepush para [sincronizar atributos](https://docs.xtremepush.com/reference/api-user-profile#user-profile-import) e associar um ID do Facebook Messenger aos seus usuários.

## Bloqueio de atributo do usuário

No bloco de atributos de usuário de configuração, você configura os quatro parâmetros que precisará passar para a API:

- `apptoken`: encontrado nas configurações da sua conta e usado para autenticação com a API
- `device_id`: passou para o chatfuel a partir do plugin, como discutido acima. No chatfuel, isso será armazenado no `{{ref}}` atributo
- `tag`: definido como "fb_messenger_id" para que a API do xtremepush saiba qual é o atributo que estamos enviando
- `value`: definido para ser o valor real do ID do Facebook Messenger no ChatFuel. Isso será armazenado no `{{messenger user id}}` atributo

Veja como esse bloco fica no chatfuel abaixo:

![1336](https://cdn.document360.io/b056e88b-f6c1-4bd2-b5b8-08e9336a17c9/Images/Documentation/a05c3e6-Screen_Shot_2018-02-15_at_16.26.24(1).png?sv=2026-02-06&spr=https&st=2026-11-04T09%3A28%3A58Z&se=2026-11-04T10%3A28%3A58Z&sr=c&sp=r&sig=6CZ%2F06%2FSPiZMB%2FPXb61Z4v6zH4tcalIRf8KcuSDl0FM%3D)

## Bloco de API JSON

Depois de configurar esse bloco, você o segue com um bloco API JSON que envia esses quatro atributos para o endpoint `https://external-api.xtremepush.com/api/external/hit/tag` da API, conforme mostrado abaixo:

![1245](https://cdn.document360.io/b056e88b-f6c1-4bd2-b5b8-08e9336a17c9/Images/Documentation/840e7dd-Screen_Shot_2018-02-15_at_16.26.37(1).png?sv=2026-02-06&spr=https&st=2026-11-04T09%3A28%3A58Z&se=2026-11-04T10%3A28%3A58Z&sr=c&sp=r&sig=6CZ%2F06%2FSPiZMB%2FPXb61Z4v6zH4tcalIRf8KcuSDl0FM%3D)